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Preface 



This manual is designed as a technical reference for the Hewlett-Packard 
12792B Eight Channel Asynchronous Multiplexer Subsystem for M/E/F-Series HP 
1000 Computers. The Multiplexer interface is an efficient, high performance 
interface for multiplexed terminal/device applications. It enhances 
terminal communications by offering a low cost per channel, high speed, high 
performance alternative to other point-to-point interface offerings. 

This manual is intended for users knowledgeable in FORTRAN and the RTE-IVB 
or RTE-6/VM operating system. The following is a brief description of the 
content of each chapter. 

The Overview provides general information concerning the multiplexer 
subsystem and its interrelationships with HP 1000 products. 

The User Interface outlines the control functions used to perform data 
transfers to and from external devices, in addition to the control functions 
necessary to accomplish 1/0 control. Examples are provided for each control 
request. 

Using the features of the multiplexer and error handling/recovery is covered 
in Chapter 3, Using The Multiplexer. 

The Device Driver chapter is directed at the advanced programmer who is 
experienced with Assembly language. It provides the user with a tutorial on 
device driver writing. 

The Device Specific Considerations chapter explains the interfacing 
requirements for using a non-HP device in the multiplexer subsystem. 
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Chapter 1 
Overview 



The Hewlett-Packard 1 2792B Eight-Channel Multiplexer Subsystem for HP 1000 
M-, E-, and F-Series computers provides multiple communications channels 
through a single microprocessor-based interface. The multiplexer signifi- 
cantly off-loads routine communication management overhead from the computer 
for higher speed operation compared to the speed achieved when a separate 
I/O card is used for each channel. The HP 12792B is referred to as the 
multiplexer, or MUX, in this manual unless its complete name is more 
appropriate. 

The multiplexer is used to route data from one of eight I/O devices to a 
common destination in direct wired installations. It may also by used with 
the Systems Modem (consisting of the HP 372UA Systems Modem Card Cage and 
one or more modem cards) to provide up to seven high-quality modem ports 
(one MUX port is used for systems modem controller card) . 

Modem operation is asynchronous full-duplex at rates up to 1200 baud. It 
also supports auto-answer for all seven ports. The subsystem includes local 
analog loop-back capability to check the integrity of the modem links. 

An example MUX configuration is shown in Figure 1-1. 
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Figure 1-1. Example Multiplexer Configuration. 



The HP 12792B can be used with Hewlett-Packard devices that communicate with 
the CPU with I/O specifications that meet RS-232-C or RS-423-A EIA 
(Electronic Industries Association) standards and that are compatible with 
the available software drivers in the HP 1000 computers. The commonly 
used devices are terminals and printers. Furthermore, users may write 
their own device drivers to handle any special control required by the 
device or where an HP driver is not available. 
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Device drivers are simply subroutines of the interface driver which are used 
to modify user requests and make them compatible with a specific device. 
The interface driver, on the other hand, is basically responsible for the 
transfer of information between the user programs, the appropriate device 
driver, and the interface card. 

Each channel of the multiplexer has a device driver associated with it. The 
device driver performs the device-specific formatting of data, which 
includes control characters for device requirements. When an EXEC call is 
issued from the user program, the interface driver passes it to the device 
driver. At this point the device driver can break up the user request into 
a series of interface requests. For example, the device driver can instruct 
the interface driver to wait for a buffer and inform the interface driver of 
the buffer's destination. The information is taken from the appropriate 
channel buffer and sent to the destination indicated by the device driver. 

Up to 14 device drivers may be used, each of which can be associated with 
one or more devices attached to one of the MUX cards in the system. HP 
supplies two device drivers with the 12792B product — DDV05 (26XX terminal 
screen mode device driver) and DDV12 (2631/2635/7310 line printer device 
driver) . 

Each MUX interface card contains 16k bytes of random access memory (RAM), of 
which 8k bytes are allocated for channel buffers. This 8k byte portion of 
memory is divided so that each channel contains four 254 byte buffers, two 
for transmission and two for reception. Each MUX card provides two on-board 
programmable baud rate generators which control channel transmission speeds 
ranging from 50 to 19.2k baud. The total aggregate throughput must not 
exceed 78.6k baud. This card may be inserted anywhere in the backplane of 
the CPU, unless there is a privileged interrupt fence. In this case the 
interface card should be inserted above the fence. 

The maximum number of physical devices which will be supported in the 
multiplexer subsystem is 61. There are 63 available EQT's in the system but 
one EQT should be reserved for the system console and one for the disc. The 
multiplexer does not offer system console support. 

To increase the throughput of the MUX card, direct memory access (DMA) is 
used. The MUX requires that DCPC is installed in the system CPU and in any 
I/O extender box that contains a MUX card. If all DMA channels are busy and 
none can be allocated to the terminal/device channel within a 160 
millisecond timeout period, the interface driver performs the read/write 
function on a word-by-word basis. The word-by-word transfers are broken 
into 64 character blocks. 

The HP 12828A Multiplexer Panel contains eight RS-232-C ports. This 
standard accessory panel is hardwired connecting port to one baud rate 
generator, and ports one through seven to the other baud rate generator. 
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The multiplexer panel is connected to the MUX card and can be at the CPU 
(with the standard cable) or up to 91 metres (300 feet) away from the CPU 
with custom cabling. RS-232-C compatible devices can then be connected to 
the multiplexer panel by cables less than 39.7 metres (50 feet) in length. 

The MUX will support asynchronous, full-duplex modems through the 
systems modem (HP 3721 4A Card Cage and modem cards). 
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Chapter 2 
User Interface 



General Considerations 



This section describes the driver as seen by the user. Standard I/O EXEC 
calls are used to transfer data to and from external I/O devices in addition 
to performing various I/O control operations. Input, output and control 
requests to the multiplexer are generally in the form of RTE EXEC calls 
while control requests can be initiated either from EXEC calls or by using 
the file manager CN command. EXEC calls can be made from Assembly Language 
programs or from higher level languages such as FORTRAN and PASCAL. 



Request Code 

Parameter ICODE identifies the type of EXEC call request. There are eight 
types of EXEC calls described in this manual; four normal I/O EXEC calls and 
four Class I/O EXEC calls. 

STANDARD EXEC CODE PARAMETERS 

ICODE =1 READ REQUEST 

ICODE = 2 WRITE REQUEST 

ICODE = 3 CONTROL REQUEST 

ICODE =13 I/O STATUS REQUEST 

CLASS I/O EXEC CODE PARAMETERS 

READ REQUEST 
WRITE REQUEST 
WRITE/ READ REQUEST 
CONTROL REQUEST 



ICODE 


= 


17 


ICODE 


= 


18 


ICODE 


= 


20 


ICODE 


= 


19 
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Control Word 



Control word (ICNWD) contains a five-bit function code and the logical unit 
(LU) number of the device to which the user request is directed. It is 
structured as follows: 



15 



10 



6 5 



0000XAKVM 



L L L L L L 



k 



— function — > 
code 



< — logical unit-> 
number 



Function Code 



The octal value of the required function code is provided for each of the 
request descriptions in the following sections. The user may choose any of 
the methods described in this chapter to set the value of bits 10 through 6 
of control word ICNWD. For example, if the function code value is octal 6, 
add 600B to the value of the LU number. 

The MUX driver examines the value of the function code to determine the 
action taken by the interface driver in the processing of I/O or device 
control. The requests will vary depending on the function codes described 
below. These function codes are used whenever an EXEC 1 (Read), EXEC 2 
(Write), or EXEC 3 (Control) call is made, although the bit meanings differ 
between read and write requests. Refer to Figure 2-1 for ICNWD bit names. 



Logical Unit Number 

The logical unit (LU) number is the system address for the I/O device to 
which the user is directing a request. The user's system generation listing 
enumerates the LU numbers of all I/O devices generated into the system. 

For example, if the LU number is decimal 10 and the function is octal 6, the 
value of ICNWD can be computed: 

ICNWD = 10 + 600B = 612B 
The B suffix is used to identify an octal number. 
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BIT 


10 


(X BIT) 


Transparent Mode Bit; 

- DISABLED 

1 - ENABLED 


BIT 


9 


(A BIT) 


Special buffer control bit; 

- DISABLED 

1 - ENABLED 


BIT 


8 


(K BIT) 


Echo Bit; 

- DISABLE 

1 - ENABLE 


BIT 


7 


(V BIT) 


Honesty Bit; 

- DISABLE 

1 - ENABLE 


BIT 


6 


(M BIT) 


Binary Mode Bit; 

- DISABLE 

1 - ENABLE 



Figure 2-1. ICNWD Function Code Bits. 



I/O Requests 

I/O requests are handled in a variety of ways. These requests are processed 
differently depending on the value of the function code of the control word. 
Three basic input functions are controlled by the value of ICNWD. 

- editing 

- echoing 

- terminators 
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When editing is enabled, the control word bits 6 and 10 are set to zero. If 
a delete key (rub out key) is struck, the contents of the user's receiving 
buffer is erased. The backspace key deletes only the last character 
entered, if any. If editing is disabled, the delete and backspace keys 
would enter a 177B or 10B into the user's on-board buffer. 

If a user is inputting data with editing enabled the interface card will 
accept the data into the first of the channel's two 254-byte input buffers. 
The multiplexer handles all the edits. User input and editing can continue 
until the card's buffers are full or a valid terminator is detected. 

At this point, the on-board buffer is off loaded to the CPU. Once the 
buffer contents have been moved it cannot be edited. If the first buffer is 
filled so that the input overflows into the second buffer, the user cannot 
backspace or delete past its lower boundary into the last byte of the first 
buffer. 

In general, information is supplied to the multiplexer card in a character 
mode format and echoed back to the user for visual inspection of the buffer. 
This is not always desirable; the echo feature may be suppressed for 
passwords and special requests. 

The multiplexer card must be able to detect an end-of-record or valid 

terminator when it is encountered. Figure 2-2 lists the valid terminators 

used to signal the card to interrupt the CPU and transfer data to the user's 
program buffer. 

Figure 2-3 describes the control word bit combinations used to determine the 
interface driver's action on a read request. It is here that valid 
terminators, as well as input editing and echoing are specified. Figure 2-4 
describes the valid buffer transfer terminators. 



COMMON NAME 



OCTAL VALUE OF 
RIGHT BYTE 



carriage return 
device control 2 
record separator 
end of transmission 



CR 
DC2 
RS 
EOT 



000015 
000022 
000036 
000004 



Figure 2-2. Valid Terminators 



2-4 





ICNWD 


BITS 


ACTION TAKEN FOR READ REQUEST 


10 


9 


8 


7 6 











X 


editing enabled 

echo disabled 

CR is a valid buffer transfer terminator 

CNTRL D results in an EOT status condition 

and a zero length transmission log (zero 

length buffer) 








1 


X 


input editing enabled 

echo enabled 

CR is a valid transfer terminator 

CNTRL D results in an EOT status condition 

and a zero length transmission log (zero 

length buffer) 











X 1 


input editing disabled 
echo disabled 

data transfer terminates only when the user 
buffer is full 








1 


X 1 


input editing disabled 
echo enabled 

data transfer terminates only when the user 
buffer is full 


1 








X 


input editing disabled 

echo disabled 

CR is a valid transfer terminator 


1 





1 


X 


input editing disabled 

echo enabled 

CR is a valid transfer terminator 


* 


1 


* 


X * 


special buffer transfer 

same as the transfer with bit 9 (special 
function bit) set to zero but data 
resident in the card's buffer that 
exceeds the end of the user buffer is 
not destroyed. It may be accessed in 
subsequent buffer transfers. 

* echo, edit, etc. are defined by bits 6, 8, 
and 10 above. 

X = don't care condition 



Figure 2-3. Read Request Function Codes. 
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ICNWD BITS 


ACTION TAKEN FOR WRITE REQUESTS 


10 9 8 7 6 


X X X An ASCII write request will have CR/LF 

appended to the buffer if the last 
character in the buffer is not "_". 
If the underscore, 00137B, is appended to 
the user's buffer it will not be printed. 

X X X X 1 the entire buffer is transmitted as is, 

1 X X X X no characters are appended to the user's 

buffer. 

X = don't care condition 



Figure 2-4. Write Request Function Codes. 



There are some areas of I/O request handling that require special mention: 

a. Zero-length keyboard entries will not be ignored by the interface 
driver. A carriage return without data is a zero length record. 

b. Function code 30B configures the multiplexer card to conduct I/O 
transfers in a specified character format. The terminal must be 
configured accordingly for successful I/O processing to occur. 

c. Read or write function codes of 35B bypass any modem connection checks. 
Refer to the section on modems. 



Standard I/O EXEC Calling Sequences 



The following sections show the general formats used for making EXEC calls 
from RTE Assembly, RTE FORTRAN IV and PASCAL/ 1000 programs. In the 
following examples, the only names that must be used as given are EXEC and 
ABREG. Other parameters used such as ICODE, ICNWD, and IPARM are simply 
mnemonics used in this manual. 
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EXEC Calls From Assembly Language 



The Assembly language calling sequence for EXEC calls is as follows: 



EXT EXEC 



Declare EXEC as an external 





JSB EXEC 




DEF RTN 




DEF ICODE 




DEF ICNWD 




DEF IPR1 




DEF IPR2 


RTN 




* 




* 




» 





Transfer control to RTE 

Return address 

Request code 

Control word 

Parameter 1 , optional 

Parameter 2, optional 

Return Point 

A register contains I/O status 
B register contains the length of the 
transmission log 



ICODE 
ICNWD 



DEC 1 
OCT CNWD 



Request code word (READ) 

Control word. Control Function plus 

LU number assigned to the port. 



IPR1 
IPR2 



OCT pr1 
OCT pr2 



Use depends on 
type of call 



The return point, labeled RTN, must follow the DEF of the last parameter 
used. EXEC uses this address to calculate the number of parameters passed 
for those calls that have optional parameters. 
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EXEC Calls From FORTRAN 

To call EXEC as a subroutine from RTE FORTRAN IV, use the following calling 
sequence: 



I CODE = 3 

ICNWD = 600B + LU 



CALL EXECQCODE, ICNWD, IPARM1 .IPARM2) 
CALL ABREGUA.IB) 



EXEC can also be called as a function from RTE FORTRAN IV, using the 
following calling sequence: 



DIMENSION IREGC2) 

EQUIVALENCE (REG.IREG) ,(IA,IREG) ,(IB,IREG(2) ) 



REG = EXECUCODE, ICNWD, IPARM1 .IPARM2) 



The two different methods of calling EXEC from FORTRAN illustrate the two 
ways of obtaining the A- and B-Register values from the EXEC call. 
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In the following sections, the examples used to illustrate the calls are 
written using the CALL EXEC(...) method, with an example showing how to make 
the control request from the File Manager using the CN command. 



EXEC Calls From PASCAL 



An EXEC call may be coded in PASCAL/1000 either as a procedure or as a 
function. If it is coded as a function, the return value type must be a 
two-word type to return the values of both the A- and B-Registers. 

The PASCAL/ 1000 compiler does not treat an EXEC call in any special manner. 
Therefore, it is possible to call EXEC directly if an external declaration 
has been made with a set of formal parameters. 

If the $HEAP 2$ compiler option is used, then the HEAPPARMS option must be 
OFF for EXEC external declarations with VAR parameters. 

An example of EXEC call in PASCAL is as follows: 



program mux ex; 
const 



type 



1 u_contr ol_r eque st_cod e 
shift_left_six_bits 
lu_number 
function_code 

int = -32768.. 32767; 



bit = 0. 


.1; 




bit_def 


= packed record 




bit 15 ; 


0..1 




bit 14 : 


0..1 




bit 13 : 


0..1 




bit 12 


. 0..1 




bit 11 


. 0..1 




bit 10 


: 0..1 




bit 9 


0..1 




bit 8 


. 0..1 




bit 7 


. 0..1 




bit 6 


. 0..1 




bit 5 


: 0..1 




bit 4 


: 0..1 




bit 3 


: 0..1 



{ EXEC 3 i a control request 
3 ; {is placed on LU 19. The 16 

{ bit control word is stripped 
= 64 ; {of bits 15-11, so that the 

{ function code, bits 10-6, 
= 19 ; t can be examined. In this 

{ case the function code 6 
= 6 ; {is placing a status request 

{ to LU 19 



{ single-word integer type 

{ single-bit type 

{ bit data type 

{ This allows the user to 

{ access each bit field 

{ individually. 
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bit 


2 : 


0. 


.1; 






bit 


"1 : 


0. 


.1; 






bit" 


"0 : 


0. 


.1; 


nd; 












ord_ 


def 


= record 










CASE 


int 


of 










1 : 


( 


bits 








2 : 


( 


word 



end; 



{ word data type } 



bit_def); { this double definition } 

int ); { allows the user to access } 

{ the information bit by bit} 

t or as a word } 



var 



control_word 

sub_f unction 

a_reg 

b_reg 

S1 



int; 

word_def ; 
word_def ; 
word_def ; 
text; 



procedure rte_exec_call $alias ' EXEC'$ 

(request_code : int; 
var control_request : int; 
var subf unction : word def) ; 



external; 



procedure get_the_a_b_registers $alias 'ABREG'$ 

(var a:word def; var b 



word def); external; 



procedure initialize_sub_f unction ; 

begin { initialize optional parameters } 



sub_f unction. bits.bit 15 


= 





sub_function.bits.bit_1 4 


= 





sub_function.bits.bit_13 


~ 





sub_f unction. bits. bit_1 2 


= 





sub_function.bits.bit_1 1 


= 





sub_function.bits.bit_10 


= 





sub_f unction. bits.bit_9 


= 





sub_f unction. bits. bit_8 


= 





sub_f unction. bits.bit_7 


= 





sub_f unction. bits. bit_6 


= 





sub function. bits. bit 5 


r 





sub_function.bits.bit_4 


= 





sub_f unction. b its. bit_3 


= 





sub_f unction. b its. bit_2 


= 





sub_f unction. b its. bit_1 


= 





sub function. bits. bit 


= 






end; 
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begin { beginning of main program } 



initialize_sub_f unction; 
sub_f unction. bits. bit_1 
sub_function.bits.bit_3 
sub_f unction. bits.bit_5 
sub_f unction. bits. bit_7 
sub function. bits. bit 9 



{ set the appropiate bits } 
{ in the optional parm } 



} 

{ construct the control word } 

control_word := lu_number+(function_code*shift_left_six_bits); 

{ place the RTE EXEC call } 

rte_exec_call (lu_control_request_code, 

control_word, sub_function) ; 

get_the_a_b_registers (a_reg,b_reg) ; 

begin { examine the A-register for the status of this channel } 

reset (S1,'1'); 
{ 



} 
if a_reg.bits.bit_15 = 
then 

if a_reg.bits.bit_l4 = 
then 

writeln (S1, 'unit available for use') 
else 

writeln (S1,'unit disabled*) 
else 

if a_reg.bits.bit_14 = 
then 

writeln (S1,'unit currently in operation 1 ) 
else 

writeln (S1, 'unit waiting for DMA channel'); 
{ 



end; 
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end. { end of PASCAL example } 



It may be necessary or desirable to use aliases for each EXEC service used 
in a program for the following reasons: 

- The name EXEC represents an entire class of services. A program 
using EXEC calls will be more readable if a descriptive PASCAL/1000 
name is given to each service. 

- Each EXEC service requires a different set of parameters. Some 
services (e.g., EXEC 11) have optional parameters. Each PASCAL/ 1000 
routine must have a specific set of parameters. 



EXEC Call Parameters 



Request code ICODE and control word ICNWD, in that order, are the first two 
parameters of an EXEC call. Other parameters, when needed, are described 
for each request in the following sections. 



Control Requests To The MUX 

Control requests have the following general format: 

CALL EXEC( ICODE, ICNWD, IPARM) 

Request code ICODE has a value of 3 for all control requests. Each control 
request has a different function code specified in ICNWD, and the value of 
the IPARM parameter depends on the function code. Table 2-1 contains a 
summary of the function codes and their meanings. 

Equipment Table word five (EQT5) contains the status word. If a control 
request is made to an unbuffered EQT (Equipment Table), the A-register will 
contain the device's status. If the EQT is buffered, the A-Register is 
meaningless. In either case the B Register is meaningless, except for 
function code 6B This status request will return the length of the 
type-ahead data in the B-register. 

When issuing a function code command from the File Manager the following 
format is used: 
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:CN,lu,fn[,pr] 

lu = LU number 

fn = function code 

pr = optional control parameter 

Table 2-1. Control Request Function Codes 



CODE 


DESCRIPTION 


PARAMETERS REQUIRED 


6B 


DYNAMIC STATUS OF PORT 


NO 


10B 


INITIATE MODEM LOOP TEST 


YES 


12B 


TERMINATE RECEIVE BUFFER 


NO 


20B 


ENABLING SCHEDULING 


NO 


21B 


DISABLE SCHEDULING 


NO 


22B 


SET TIMEOUT 


YES 


23B 


TYPE AHEAD SCHEDULE RETRY COUNT 


YES 


2UB 


SET ID SEGMENT ADDRESS OF MODEM 
ALARM PROGRAM 


YES 


25B 


GET TERMINAL CONFIGURATION 


NO 


26B 


FLUSH INPUT BUFFER 


YES 


27B 


SET PROGRAM ADDRESS 


YES 


30B 


SET PORT'S ID 


YES 


31B 


CONNECT MODEM LINE 


YES 


32B 


DISCONNECT MODEM LINE 


YES 


33B 


CONFIGURE DRIVER RESPONSES 


YES 


3UB 


SET PORT CONFIGURATION 


YES 


36B 


SET READ BINARY LENGTH 


YES 


37B 


SET READ TYPE 


YES 



For example, to place LU 19 in type-ahead mode 
following control command is issued. 



with cancel on break, the 



:CN,19,33B,23000B 
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Device Initialization 



Device initialization is accomplished by executing the following three 
control requests. 

Typically this is done for each terminal from your WELCOM file, but can be 
executed interactively: 

- set port ID (required) 
function code 30B 

- configure driver responses (optional) 
function code 33B 

- enable scheduling (optional) 
function code 20B 



Interface Driver Control Requests 



Function Code 6B: Dynamic Status 

Dynamic Status can be used to find out the status of the previous request 
and to determine the length of the type-ahead data in the input buffers. 

An example of a dynamic status request to LU 42 is coded as follows: 

ICODE = 3 

ICNWD = 600B+42 

CALL EXEC( ICODE, ICNWD, IPARM1) 

CALL ABREG(IA.IB) 



If IPARM1 is set to zero, the B-register will contain the character count of 
any type-ahead data. If IPARM1 is not set to zero, modem related port 
status will be returned in the B-register (providing that a modem is being 
used through the system's modem panel). 
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The status bits returned in the A-register are defined as follows: 

Bits 15-7 Undefined 

Bit 6 Break key hit 

Bit 5 EOT (control-D) entered on last request 

Bit h Device failure (e.g., modem line down) 

Bit 3 Parity error or overflow detected on last request 

Bit 2 Type-ahead data available (length in B-register) 

Bit 1 Program schedule enabled 

Bit Last request timed out 

The modem related status returned in the B-register (if IPARM1 not zero) is 
defined as follows : 

Bits 15-8 Undefined 

Bit 7 = connected to systems modem panel 
1 = hardwired (no systems modem panel) 

1 = no response from systems modem 

1 = modem not present 

1 = being called 

= analogue loopback 

1 = remote digital loopback 

Bit 2 = not in loopback mode 
1 = loopback completed 

Bit 1 = low speed 
1 = high speed 

Bit = line disconnected 
1 ■= line connected 

Note: On power-up, the B-register status equals 200B and it will remain so 
if an HP 3721 UA modem panel is not connected to the MUX. 

The dynamic status request is a call to the driver; therefore, it will wait 
until any outstanding requests to that LU have completed. 
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Bit 


6 


Bit 


5 


Bit 


U 


Bit 


3 



Function Code 10B: Loop Test 

Function Code 10B performs a local analog or a remote digital loop test when 
using the HP 37213 Modem Card and only applies to this card in the HP 3721UA 
Systems Modem Card Cage. For loopback tests using other modems, refer to 
the instructions in their appropriate manuals. For these tests, the ENQ/ACK 
handshake and ECHO must be off. 

After initiating a loop test, wait for approximately three seconds and then 
confirm that the modem being tested has looped the data lines by reading the 
port status (refer to Dynamic Status, Function Code 6B) . After confirming 
the loopback, the user can put the port in a type -ahead mode and then 
perform the integrity check of the modem line by comparing the received data 
against the transmitted data. After the test, the user can disable the 
loopback by making another control request with function code 10B and with 
IPARM1 set to 0. 

Note that if a port's modem line status is "down", the driver DVM00 will 
pass only the write request with function code 35B to the card. Therefore, 
if the loopback port is "down", the user should use the write request with 
function code 35B to send the loopback data to the card. The port's 
configuration should be set to "don't down the EQT on line failure" to 
prevent the EQT from going down. 

An example from file manager is: 

:CN,LU,10B,IPARM1 



where, IPARM1 is 
Bit 2: 

Bit 1: 



Bit 0: 



= low speed (300 baud). 

1 = high speed (1200 baud) 

= analog. 

1 = remote digital. 

= disable loop test. 

1 = enable loop test. 



The following is an example of a loopback test: 

:** ENABLE TYPE -AHEAD & DO NOT CHANGE READ CONFIGURATION EVERY 
TIME MODE 
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CN,LU,33B,20200B 

** SPECIFY ECHO/EDIT OFF, END TRANSFER ON CARRIAGE RETURN 
CN,LU,37B,100000B 

** INITIATE THE LOCAL ANALOG LOOPBACK MODE AT HIGH SPEED 

Update 1 



:CN,LU, 10B.5 

C«* WRITE DATA TO THE LU; USE 35B AS THE WRITE FUNCTION CODE 

CALL EXEC(2,3500B+LU,TBUFF,BUFLEN) 

C«« READ BACK THE DATA 

CALL EXEC(1,3500B+LU,RBUFF,BUFLEN) 

NOW COMPARE TBUFF WITH RBUFF (THEY SHOULD BE IDENTICAL) 

:** DISABLE THE MODEM LOOPBACK TEST 

:CN,LU, 10B.0 

:•* CONFIGURE THE PORT BACK TO ITS NORMAL MODE OF OPERATION 

:CN,LU,33B t 10100B 

Function Code 12B: Terminate Receive Buffer 



Function code 12B instructs the interface card to immediately terminate 
its active receive buffer. A subsequent read request will read the 
terminated buffer with the length of the received data returned in the 
B-register (i.e., transmission log). 

If the active receive buffer on the interface card is empty when 
function code 12B is issued, the buffer will be terminated and the driver 
will be informed as soon as the first character is received. The 
subsequent read request issued will be completed with a transmission log 
of one byte. 

This control request is useful to read incoming data which is not in a 
format known to the multiplexer; e.g., ending on <CR>, <DC2>, <RS> 
CNTL-D, or count. In other words, if a user does not know how many 
characters to expect, and if the data does not have a record terminator 
that is recognized by the MUX, function code 12B can be used to read 
the data. 

The following example shows how to read data from a device connected to 

the multiplexer: (The length of the incoming data is not known ahead of 

time and/or the record terminator is not recognized by the multiplexer. 

Also the port must be configured to type-ahead mode and the character 
count is set to 254.) 
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c 

C PROGRAM THE MUX PORT IN TYPE-AHEAD MODE & SPECIFY NOT TO 
C RECONFIGURE THE READ OPERATION ON A READ REQUEST. 



C 



CALL EXEC(3,3300B+LU,22200B) 



C 

C SET THE READ CONFIGURATION TO END ON A COUNT OF 254, ECHO & EDIT OFF 

C 

CALL EXEC(3,3600B+LU,25M) 

CALL EXEC(3,3700B+LU,4000B) 
C 

C THE FOLLOWING LOOP WILL TERMINATE & READ THE INCOMING DATA BUFFER 

C 
10 CALL EXEC(3,1200B+LU,0) 

CALL EXEC(1,LU, BUFF, -254) 
CALL ABREG(ISTAT.LEN) 
C 

C LEN HAS THE LENGTH OF THE DATA RECEIVED 

C 



C 

C PROCESS THE RECEIVED DATA 

C 



C 

C READ SOME MORE DATA 

C 

GO TO 10 



Instead of doing a read after the terminate request, a user may choose to 
schedule a program when type-ahead data is available. This can be done by 
setting bits 11-10 to "10" in a control request with function code 33B. The 
program to be scheduled is specified by function code 27B. After the 
terminate request is issued, the program will be scheduled as soon as the 
type-ahead data is sent to the driver by the interface card. The scheduled 
program will then read the data, and if desired, issue another terminate 
request to read more data. 



Function Code 20B: Enable Scheduling 

Function code 20B enables the driver to schedule a program on interrupt. 
The program to be scheduled is specified at generation or the driver can 
interactively be informed of the address of the program's ID segment through 
function code 27B. Scheduling will commence if the following conditions are 
met: 
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1. Scheduling is enabled 

2. The program to be scheduled is dormant (state 0) 

3. A read operation is not in progress. 

4. The port is not in type-ahead mode and any key is hit 

-or- 

The port is in type-ahead mode and the break key is hit (see 
control 33B regarding type-ahead and the break key). 

-or- 

The port is in the type-ahead mode with "scheduling on data 
available" and a valid terminator, or count, is received. 

To enable scheduling and schedule a program on an unsolicited interrupt the 
following request is issued: 

ICODE = 3 

ICNWD = 2000B+LU 

CALL EXEC( ICODE, ICNWD) 

or to enable scheduling on an unsolicited interrupt at LU 41: 

CN.41.20B 



Function Code 2 IB: Disable Schedule 



Function code 21B resets the flag set by function code 20B (enable 
scheduling). When a terminal is disabled, striking a key on the keyboard 
will not schedule the program specified at generation or by Control Request 
27B. Once a port is disabled, programs will not be scheduled. At boot-up 
time the default value of the schedule enable flag is disabled. 

For example, to disable LU 41: 
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I CODE = 3 

ICNWD = 2100B + kl 

CALL EXEC (I CODE, ICNWD) 



OR 
:CH,Ul,21B 
To re-enable the terminal an "Enable Schedule" request must be issued: 
:CN,l4l,20B 



Function Code 22B: Set Timeout 

To alter the RTE device time-out value that was established at system 
generation, use function code 22B. The time-out value can be set in 10 
millisecond intervals by the integer provided as an additional parameter. 

Time-out values can also be set by using the system TO command. The RTE 
Programmer's Reference Manual describes how to use the TO command. When 
using a control request or the File Manager CN command, be sure to specify 
the channel or device by LU number; when you use the TO command, specify the 
channel by the EQT number. The TO command checks for a lower limit of 500 
milliseconds but function code 22B does not. 

The timer specifies the number of tens of milliseconds to wait for keyboard 
input. If this time is exceeded before a user keyboard input completes, the 
| driver sets bit in the terminal's status byte and returns to the caller 
with a zero length transmission log. 

For example, to set the timeout of LU kl to 25 seconds: 

ICODE = 3 

ICNWD = 2200B + Ul 

ITO = 100 * 25 

REG = EXEC (ICODE, ICNWD, ITO) 



OR 
CN, kl, 22B, 2500 
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Function Code 26B: Flush Input Buffer 



Function code 26B instructs the interface card to clear any data from the 
channel's input buffer which might have accumulated in the type-ahead mode. 
The value of IPARM indicates whether only the active buffer (IPARM=0) or all 
of that port's receiving buffers (IPARM=1) should be cleared. Function code 
26B ensures the user that the information requested is what is obtained, 
eliminating the possibility of processing any outstanding data previously 
entered. To flush only this channel's active buffer use IPARM=0. Setting 
IPARM=1 will flush the two 254 byte input buffers on this port. 

For example, to flush the two input buffers on LU 41: 

I CODE = 3 

ICNWD = 2600B+41 

IPARM = 1 

CALL EXEC(ICODE, ICNWD, IPARM) 



OR 
CN,41,26B,1 

Function Code 27B: Set Program Address 



Function code 27B saves the value of IPARM as the address of the ID segment 
of a program to be scheduled on an unsolicited interrupt. If the value of 
IPARM is zero or negative, program scheduling is disabled regardless of 
function code 20B. This call will override for this particular port the 
value set at system generation time. This function code is intended for 
programmatic rather than interactive use. 

A program's ID segment address can be found using the system utility 
subroutine IDGET. Care should be exercised that the address supplied is 
correct and points to an ID segment of a permanently loaded program. On 
return, the B register is set to the address of the old ID segment. For 
example, if IADDR contains the address of a program's ID segment, this 
program will be scheduled on an unsolicited interrupt. IADDX will be set to 
the previous program ID segment address, if the EQT is unbuffered. 



2-21 



ICODE = 3 

ICNWD = 2700B+LU 

CALL EXEC( ICODE, ICNWD, IADDR) 

CALL ABREG (IA.IADDX) 



OR 
CN.LU.27B, IADDR 

Function Code 30B: Set Port ID 



Function code 30B establishes a logical connection between the logical unit 
and the physical terminal connected to the interface. This function is 
normally executed from the WELCOM file to initialize and configure ports 
through 7, but can be done interactively. Function code 30B must be given 
before any other request is given to that port. If other commands are sent 
prior to this function call they may be ignored. 

The value of IPARM for function code 30B is defined as follows: 

Bits 15-14: # bits per character for transmission and reception. 
This does not include parity. 

0=5 bits/char 2 = 6 bits/char 
1 = 7 bits/char 3=8 bits/char 

Bit 13: 1= Enable this port as a modem LU. 

= Do not enable this port as a modem LU. 

CAUTION: Do not set bit 13 if you are not using a modem in the 
port since setting this bit causes port 7 to be assigned to the 
37214A Systems Modem Card Cage prohibiting its (port 7) use 
as a hardwired port. Conversely, if you want to use a modem 
with the Systems Modem, do not configure port 7 with a function 
code 30B. 

Bit 12: Baud rate generator for this port: 

= baud rate generator 

1 = baud rate generator 1 

Bits 11-10: # stop bits: 

All data transfers to and from the interface card 
require a delay between each character. For all 
asynchronous transfers there is always at least 
one stop bit. 

= reserved 2 = 1-1/2 bits 

1 = 1 bit 3=2 bits 
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Bits 9-8: Parity select: 

= none 2 = none 

1 = odd 3 = even 

Bit 7: 1 = ENQ/ACK handshake enabled 

= ENQ/ACK handshaking disabled 

Bits 6-3: Baud rate: 

= no change 8 = 1800 

1 = 50 9 = 2U00 

2 = 75 10 = U800 

3 = 110 11 = 96OO 
U = 13^-5 12 = 19200 

5 = 150 13 = reserved 

6 = 300 lU = reserved 

7 = 1200 15 = reserved 

NOTES for Bits 6-3: 

1. The 19200 baud rate is not supported on eight channels 
simultaneously since it would exceed the maximum throughput 
of the card (768OO baud). A baud rate parameter of zero 
will not change any of the port's parameters (baud rate, 
parity, stop bits, etc.). 

2. The MUX card has two on -board baud-rate generators 
providing baud rates to the eight ports. These eight ports 
can be divided into two groups and connected to either of 
the two generators. However, all ports on a given 
baud-rate generator must be initialized to the same baud 
rate with the exception that (75 and 150) or (300 and 1200) 
or 2U00, or (U800, 96OO, and 19200) can be simultaneously 
selected. 

For example, assume that ports 0-3 are connected to baud-rate 
generator and ports U-6 are connected to baud-rate generator 
1; and that a modem card is plugged into port 5. If port is 
set to 96OO baud, then ports 1-3 must be set to either W300, 
9600, or 19200 since they are on the same baud-rate generator. 
Also if the modem is initialized to auto-answer, the modem must 
be set to 1200 baud, and if the modem port is set to 1200 baud, 
then the other ports on baud-rate generator 1 (ports k and 6) 
must be set to either 300 or 1200 baud. 

When the MUX is connected to the HP 3721UA Systems Modem, the 
firmware uses port 7 to communicate to the systems modem 
controller at 1200 baud. Hence, port J should be grouped with 
the modem ports which will be run at 300 or 1200 baud. 
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3. The baud rate should be set to 300 or 1200 baud as required 
while originating a call. If you are in auto answer mode, 
the baud rate should be initially set to 1200 baud. The 
firmware will automatically change it to 300 baud if the 
systems modem detects that the remote modem is calling in 
at low speed (300). This is referred to as speed sensing. 

Bits 2-0: Port number of this terminal (0-7) 

For example, to set the port ID of an HP 2621 terminal on channel 0, as 
LU Ul, with a baud rate of 96OO, ENQ/ACK handshaking enabled, and no parity 
the following control request is issued: 

CN,Ul,30B,lU2330B 

Function Code 23B: Type Ahead Schedule Retry Count 

This control function applies only to ports that have been configured to 
schedule a program when type-ahead data is available. CN 23B is used to 
specify the number of attempted scheduling retries to make if the program is 
busy before giving up. Retries are attempted every 100 milliseconds. For 
example, normally when type-ahead data becomes available the program to be 
scheduled is not busy and is scheduled successfully. However, on occasion 
it is possible for the program to be busy and the schedule fails. If a CN 
23B had been previously done such as when the port were initially 
configured, then after 100 milliseconds, another schedule request is 
attempted . 

CN,LU,23B,0 — ► Retry times (attempt to schedule only once) 

CN,LU,23B,500 — ► Retry 500 times 

CN,LU,100000B — ► Bit 15 set, retry indefinitely. 

The default is 0, i.e., try to schedule the program once and if it's busy, 
don't try to schedule it again. 

Function Code 24B: Set ID Segment Address of 
Modem Alarm Program 

This control function is used to tell the driver the ID Segment address of a 
modem alarm program, i.e., the program to be scheduled if a modem line is 
disconnected on the 37213A System Modem Panel. Program MODEM is available 
(Part No. 92077-16391) for use as a disconnect program and should suffice 
in most situations. MODEM can be configured to terminate active programs 
and log off a session upon disconnect. 

The program's ID segment address (whether it be MODEM or some other program) 
can be found using the system utility subroutine, IDGET. As in CN 27B, care 
should be exercised that the .address supplied is correct and points to an ID 
segment of a permanently loaded program. If the EQT is unbuffered, then, 
the B-Register will return the address of the old ID segment. 

Update 1 
2-2U 



For example : 

DIMENSION NAME (3) 
DATA NAME /'MODEM'/ 



IDADDR=IDGET (NAME ) 

CALL EXEC(3,2ltOOB+LU,IDADDR) 

CALL ABREG(IA,IADDX) ! If EQT of LU is unbuffered, IADDX = previous ID 

segment addrs. 



Function Code 25B: Get Terminal's Configuration 

Control function 25B causes the driver to read the strap setting on HP 
terminals. This information is used by the driver to assure correct 
terminal handshake when doing block read, etc. on HP terminals. 

A control function 25B is automatically performed when the driver receives 
its first read request. If the terminal straps are «ubsequently changed 
manually or by escape sequences, the user must issue another control 
function 25B to keep the driver posted of any changes. Failure to do so may 
result in the terminal getting "hung up". 



Example 1: INTEGER PAGE (3) 

DATA PAGE/15^6B,7lU6lB,U2000B/ 



ESC&slD 



CALL EXEC(2,LU,PAGE,-5) 
CALL EXEC(3,2500B+LU) 



Put terminal into page mode 
Inform driver of strap change 



Example 2: INTEGER BLOCK (3) 

DATA BLOCK/15UU6B,65U6lB,Ul000B/ ! ESC&klB 



CALL EXEC ( 2, LU, BLOCK, -5) 
CALL EXEC(3,2500B+LU) 



! Put terminal into block mode 
! Inform driver of strap change 
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Function Code 31B: Connect Line 

If the 3721UA Systems Modem Panel is being used, issuing function code 31B 
will establish a modem connection. This function code can also specify the 
name of a program to schedule when a modem line disconnect takes place. 
Program MODEM is available (Part No. 92077-16391) for use as a disconnect 
program and should suffice in most situations. MODEM can be configured to 
terminate active programs and reinitialize the modem port for auto-answer. 
Also, if the application requires it, MODEM can terminate and log off a 
session upon disconnect. 

Once the connect line has been performed on a given port, the user need not 
do it again unless a power fail occurs or a disconnect request is executed. 
In the event that the modem gets disconnected accidently, the user will be 
able to call back and establish the connection. However, in the case of an 
auto dialed call, the user will have to make a connect line request again to 
perform the auto dialing. When the line gets disconnected the action taken 
by the driver is selected according to the user specification of bits 15 and 
lU in function code 33B (i.e., down or do not down the device if the line 
gets disconnected). Connect line can be done interactively or 
programmatically by EXEC request. For example: 

:CN,LU,31B,IPARM1 

where IPARM1 is as follows : 

Bit 15: No Wait bit 

= driver will complete the request (i.e., return) only after 

line has been connected. 

1 = driver will not wait for the line to be connected before 

completing the request. 

Bit lU through 6 apply only to program MODEM. 
Bit Ik: If the modem line goes down, 

= abort active programs and log off the session 

1 = do not abort active programs nor log off the session 

Bit 13 through 6 = Log LU for messages from program MODEM 

Bits 5-3: Configuration straps for the HP 37213A modem card. These 
straps will not affect the configuration of the external modem 
connected to the HP 37215A modem interface card. (The modem 
cards are contained in the HP 3721UA modem card cage.) 

Bit = 10 bits 
1=9 bits 
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Bit = 212 mode 
1 = V.22 mode 

Bit = guard tone off 
1 = guard tone on 



2: 





= 


originate 




1 


= 


answer 


1: 





= 


manual 




1 


= 


auto-dial 



Bit 



Bit 



Bit 0: = low speed (300 baud) 

1 = high speed (1200 baud) 

If the user wants to auto-dial, the number to be dialed is specified before 
the Connect Line request by making a write request with function code 35B as 
follows : 

CALL EXEC (2,3500B+LU,BUFR,BUFLN) 

Where: LU = LU of the modem 

BUFR = buffer that contains the phone number (AUTO -DIAL BUFR) 
BUFLN = length of BUFR 

Function code 35B tells the driver that this is a special write buffer. The 
AUTO-DIAL BUFR should start with a <T> or <P> for DTMF tone or pulse dialing 
followed by a string of numbers. The format of the BUFR is: 

T+n+n+n+ . . . n+n+n or P+n+n+n+ . . . n+n+n 

where + is a delimiter. Other valid delimiters are: 

SP ( ) , - / 

A delimiter need not be sent. Consistency of the choice of delimiters is 
not needed and any number of delimiters may be sent. 

n is a digit to 9i or * 

An * will cause an access pause of two seconds during dialing. Up to two 
access pauses may be included. The total number of digits including pauses 
cannot exceed 125. 

Examples : 

a. P /031/331 - 1000 (Pulse dial the number 031 331 1000). 

b. T 9 * 0101 (916) 786 2001 (Tone dial 9 0101 916 786 2001 with an 
access pause after the first digit). 
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Function Code 32B: Disconnect Line 

Function code 32B disconnects a line from being used as a modem line. Once 
a Disconnect Line request is done, an incoming call cannot establish a 
connection until a Connect Line request is executed unless the local modem 
is programmed to auto-answer a call. 

This request can be done from file manager as well as an EXEC call. For 
example, from file manager: 

:CN,LU,32B,IPARM1 

where IPARM1 is as follows: 

Bit 15: No Wait bit. 

= driver will complete the request (i.e., return) only after 

line has been disconnected. 

1 = driver will not wait for the line to be disconnected before 

completing the request. 

Bit lU: Applies only when program MODEM is used. 

= abort active programs and log off the session upon 

disconnect 

1 = do not abort active programs nor log off the session upon 

disconnect 

Bit 13-1: = Reserved; set to 0. 
Bit 0: 1 = disable auto-answer. 
Program "MODEM" consists of the following: 

1. Main program %M0DEM (92077-16391) 

2. Library %MDMLB (92081+-16958) 

Permanently load MODEM using the loader. 

RU,LOADR:IH 
0P,PE 
LI,%MDMLB 
RE,%M0DEM 
EN 

A typical output message from MODEM is as follows: 

MDM: LINE DISCONNECT DETECTED 5=^5 PM TUE., 20 SEPT, 1983 
MDM: 12792B ST= 3^10 LU 71 
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The following is an example of a program to get the ID segment address of 
program MODEM and issue a CN 2*+B. 

FTN7X,L 

PROGRAM IDADD 
C 

C :RU, IDADD, PI program to get MODEM' s id segment addrs & issue CN 2U 
C PI = LU 

DIMENSION IPARM(5),NAME(3),IFCN(2) 

DATA NAME/' MODEM '/ 
C 

C --- GET LU 
C 

CALL RMPAR(IPARM) 
C 

C --- GET ID SEGMENT ADDRESS OF PROGRAM 'MODEM' 
C 

IDADDR=IDGET(NAME) 

WRITE (1,5) IDADDR,NAME ! Display the ID segment address. 

5 FORMAT ("IDADDR= ",07," of ",3A2) 

IF(IDADDR.EQ.O) STOP 
C 

C --- ISSUE CN 2UB 
C 
8 IFCN(2)=2U00B 

IFCN(1)=IPARM(1) 

CALL XLUEX(3,IFCN,IDADDR) 

CALL ABREG(IA,IB) 

WRITE(1,10) IA,IB,IPARM(1) 
10 FORMAT ("ISSUED CN 2UB; IA=",07," ; IB=",07," ; TO LU=",I3) 
C 

C --- DONE. 
C 

Ik WRITE (1,15) 

15 FORMAT ("IDADD : DONE") 

END 

END$ 

The following is a typical transfer file to initialize a 37213A modem port, 
specifying the use of program MODEM. 



CN,21,30B,172271B 

CN,21,33B,0l40003B 

CN,21,31B,100105B 

CN,21,l6 

SYT0,15,0 

RU, IDADD, 21 



,,MUX MODEM PORT 1; 1200 BAUD 

,,D0WN THE DEVICE IF LINE GOES DOWN; ATTACH DDV05 

, , ENABLE FOR AUTO-ANSWER; ABORT SESSION; LOG TO LU 1 

,, ENABLE SCHEDULING OF PRMPT 

,,SET T.O. = 

,, ISSUE CN 2kB TO SET ID SEGMENT ADDRS OF "MODEM" 



** MODEM PORT UP & ENABLED FOR AUTO-ANSWER 
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The following is a sample dial-back program which is compatible with 
Racal-Vadic modems model VA3 1 +51- The user calls in to the system from a 
remote site via a VA3**51 and logs on. Then he runs the DIAL program to have 
the system call him back so that his identity can be verified and/or the 
phone charges absorbed by the system's phone. 

f tn7x , 1 

C 

C PROGRAM "DIAL" IS USED TO CALL BACK THE USER WHO IS LOGGED ON TO A 

C SYSTEM FROM A REMOTE SITE VIA MODEM. THE SYSTEM MUST HAVE EITHER 

C A 3721UA SYSTEMS MODEM PANEL WITH A 37213A MODEM CARD. THIS PROGRAM 

C IS AN EXAMPLE FOR USE WITH A RACAL-VADIC MODEM, MODEL VA3U5I. 

C 

C OPERATING INSTRUCTIONS: 

C 

C :RU,DIAL 

C What is your phone number? U15-555-729U 

C 

C or 

C 555-9732 

C or 

C 9*555-2702 

C 

C h sec access pause. 

C 

C 

program dial (3, 2000 ), autodial program TMH <8Uo801.103U> 

implicit integer (a-z) 

DIMENSION NAME(3) 

integer rmparms(5) ,phonenumberbuff (32) ,xluexparms(2) ,IDATE(15) 

character*6U phonenumber , temp 

equivalence (phonenumber ,phonenumberbuf f ) 

DATA NAME/' DIAL '/ 
C 

C Get parms 

C 

call rmpar(rmparms) 
C 

C --- PROCESS THE INPUT PARMS 
C 

WRITE (1,*) 'What is your phone number? ' 1RTE-6 
READ(1,U) (PH0NENUMBERBUFF(I),I=2,32) 1RTE-6 
k FORMAT(32A2) 1RTE-6 

PHONENUMBERBUFF ( 1 ) =2HT* 
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cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 
c c 

c INSERT YOUR OWN ROUTINE HERE TO VERIFY VALID PHONE NUMBERS. c 
c c 

cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 
c 

IF(RMPARMS(2).EQ.O) RMPARMS(2)=10 ! Default wait time to 10 sec. 
RMPARMS(3)=LUTRU(1) ! RTE-6 



10 ITIME=RMPARMS(2)+15 
WRITE(1,*) ' * 
WRITE (1,*) ' ' 

WRITE(1,*) ' +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+' 

WRITE (1,*) ' + Wait for CXR light to go out then +' 

WRITE (1,*) ' + move the DA/VO/MA switch to VO. +' 

WRITE (1,500) ITIME 
500 FORMAT(' + Your phone will ring in about' 13' +') 

+ seconds. Then in another 20 sees, + 

+ the CXR light will come on and a + 

+ WELCOME BACK message will appear. + 

+ If you are not back ONLINE in + 

+ approx 70 sees, call in again. + 



'15A2) 



WRITE (1,*) 




WRITE(1,*) 




WRITE (1,*) 




WRITE(1,*) 




WRITE (1,*) 




WRITE(1,*) 




WRITE (1,*) ' ' 


CALL FTIME(IDATE) 


WRITE (1,15) IDATE 


15 FORMAT (* 


WRITE(1,*) 


> 


WRITE(1,*) 




WRITE(1,*) 




WRITE(1,*) 




WRITE(1,«) 


» 


WRITE(1,*) 


> 


WRITE(1,*) 


> 



ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 
c c 

c INSERT YOUR OWN ROUTINE HERE TO LOG THIS CALL TO A LOG FILE. c 
c c 

ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 
c 

CALL EXEC (12, 0,2, 0,-2) ! Wait 2 sec. for messages to complete 

c Disconnect & wait for WaitTimelnSecs number of seconds before calling back. 

CALL DTACH(IX) 
IF(RMPARMS(3).EQ.0) RMPARMS(3) = 1 
XLUEXPARMS(l) = RMPARMS(3) 

XLUEXPARMS(2) = 1+3200B ! ISSUE DISCONNECT RQST. 

CALL XLUEX(3,XLUEXPARMS,l40000B) 
call exec(12,0,2,0,-rmparms(2) ) 
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c Send the phone number to the card 



XLUEXPARMS(2) = 103500B 

call xluex ( 2 ,xluexparms ,phonenumberbuf f , -60 ) 

c Tell the card to dial (high speed is the default) 
xluexparms(2) = 3100b 
call xluex (3, xluexparms, 100103b) 



•RTE-6 



C 
C 
C 



700 



--- WAIT FOR LINE CONNECT 

ITRYS=1 

XLUEXPARMS (2) = 100600B 
CALL XLUEX (3, XLUEXPARMS, 1) 
CALL ABREG(IA,IB) 
IF(IAND(IB,l).EQ.l) GO TO 900 
CALL EXEC(12, 0,2, 0,-10 
ITRYS=ITRYS+1 
IF(ITRYS.LT.IO) GO TO 700 

SCBADDR=LUSES ( XLUEXPARMS ( 1 ) ) 
CALL LOGOF ( XLUEXPARMS ( 1 ) , SCBADDR ) 

XLUEXPARMS ( 2 ) =3100B 

CALL XLUEX (3, XLUEXPARMS, 105B) ! 

STOP 



GET DYNAMIC STATUS. 
GET A & B REG. 
CONNECTION COMPLETED YET? 
NO, PAUSE ANOTHER k SECS. 

GET THE STATUS AGAIN. 

! RTE-6 LOG OFF 
! RTE-6 LOG OFF 

RE-INIT PORT FOR AUTO ANS. 



c 






900 


WRITE(1,*) 


1 




WRITE(1,*) 


» 




WRITE(1,*) 






WRITE(1,*) 






WRITE (1,*) 






WRITE(1,*) 






WRITE(1,*) ' * 




CALL FTIME(IDATE) 




WRITE (1,15) IDATE 




WRITE(1,*) ' ' 




END 





# * 

* # 



##*###* 



****##* 






Function Code 33B: Configure Driver Responses 

Function code 33B uses the IPARM parameter to specify port parameters. The 
value of IPARM will configure the driver without sending the parameters to 
the card. The bit fields are defined as follows (all fields default to the 
01 state at system boot time): 
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Bits 15-1*4 These bits are used to control responses to device or line 
failures, such as the modem line going down. 

00 = no change . 

01 = if the device or line goes down, set the device down 

(e.q., 10 NR). 

10 = if the device or line goes down, don't down the device, 
but abort the request, then return EOT and go into a hard 
flush mode (i.e., ignore all subsequent I/O requests. 
Function code 6B will return additional information 
regarding the failure. 



Bits 13-12 These bits define the type-ahead feature of the MUX card. 

00 = no change 

01 = (default value) no type-ahead. Striking any key when 

there is not a read request pending will gain the system's 
attention, if enabled. 

10 = Type-ahead data can be received without a pending read 
request. The information on the card is saved until a 
read request is made. At this point the data is 
retrieved. Only the break key will gain the system's 
attention unless type-ahead with scheduling is enabled. 

Bits 11-10 These bits define the action to be taken when type-ahead data 
becomes available. Type-ahead data is defined as "available" 
when an End-of -Record is read by the card. Valid terminators 
are defined by the previous read or through control request 37. 

00 = no change 

01 = (default value) bit 2 is set in the EQT status word. 

10 = Bit 2 is set and scheduling is attempted. 

Bits 9-8 These bits define the action to be taken when the BREAK key is 
struck. 

00 = no change 

01 = (default value) if scheduling has been enabled via control 

20, scheduling is attempted. 

10 = cancels any type-ahead data and then attempts to schedule 
the designated program. 
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Bits 7-6 These "bits control the sending of read configuration 
information to the card. Also see control 37B. 

00 = no change 

01 = This is a normal read operation. The driver examines bits 

10-6 of the control word in the user's EXEC request which 
specifies a unique read request type to the MUX card. 

10 = This will not reconfigure the read operation. When bit 7 
is set, the driver overlooks bits 10-6, and only the 
device driver or a control 37 can modify the read 
configuration type. 

Bits 5-U Reserved for future use, should be set to zero. 

Bits 3-0 These bits define the device driver attached to this port. 
Device driver number one is the default device driver that is 
included as part of the interface driver. Driver number one 
passes all of the user's request directly to interface driver. 
Device drivers number two through n (n < 16) are defined at 
system generation time. The device driver address table $DVTB 
is established at generation time and defines the association 
(relation) between a device driver number two through n and its 
device driver (refer to "Device Driver Address Table" in 
Chapter k) . For the HP 12792B Multiplexer Subsystem, device 
driver number two defaults to the HP supplied driver DDV12 and 
device driver number three defaults to HP supplied driver 
DDV05. These drivers can be overrridden by the user. Exactly 
one device driver is attached to each port at any time. If 
zero is entered no change is made. 



For example, to configure the driver response for a full type-ahead mode on 
LU Ul: 

I CODE = 3 

ICNWD = 3300B+U1 

IPARM = 0221400B 

CALL EXEC (ICODE, ICNWD, IPARM) 



OR 

CN,l*l,33B,022U00B 

NOTE: If any port is configured for a type-ahead mode, the break key must 
be struck to schedule the LOGON prompt. 
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Function Code 34B: Set Port Configuration 



Function code 
additional to 
follows : 

Bits 15-2 : 

Bit : 



3^B uses the IPARM parameter to specify port configuration 
function code 30B. The bit fields in IPARM are defined as 

Reserved for future use and should he set to zero. 
Transmit pacing with XON/XOFF. 

= Disable XON/XOFF handshake 

1 = Enable XON/XOFF handshake 

Bit 1 : Force an XON condition.* 

= Do not force XON condition 

1 = Force XON condition 

* If the XON/XOFF handshake is enabled and the printer is powered off, 
issuing CN,LU,3UB, IPARM, where IPARM=3, will force an XON condition. 

Transmit pacing is a mechanism by which the remote device can control (stop 
and resume) the transmission of data from the multiplexer. If enabled, 
transmit pacing is performed using XON and XOFF control codes. When the 
multiplexer receives an XOFF code (ASCII DC3), it stops transmitting data. 
When the multiplexer subsequently receives an XON code (ASCII DC1), it 
resumes transmitting data. 



For example: 

:CN,LU,3UB,1 
:DL,CRN 
CNTL-S 

CNTL-Q 



(Enable XON/XOFF) 

(Causes a long output to the terminal) 

(XOFF will cause the output to stop; e.g., if 

the user wants to stop to look at something) 

(XON resumes the output to the terminal) 



Note: XON and XOFF codes can be issued through the keyboards to pace the 
data transmitted to the terminal. The CNTL and Q keys (when pressed 
simultaneously) generate an XON code and the CNTL and S keys generate 
XOFF. 
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CAUTION 



If XON/XOFF transmit pacing is enabled, all CNTL-S 
characters received by the MUX are treated as handshake 
characters and therefore can't be used as data 
characters. Similarly, each CNTL-Q preceded by a CNTL-S 
is treated as a handshake character. A CNTL-Q received 
without a CNTL-S is treated as a data character. Some 
of the HP Software Programs (screen mode EDIT and BASIC) 
use XON and/or XOFF characters to perform line and/or 
page editing. It is advised that these characters are 
not used for editing and handshaking at the same time. 
A CNTL-Q can be used for editing as long as it is not 
preceded by a CNTL-S. Similarly, it is recommended that 
the XON/XOFF transmit handshake is disabled while 
sending binary data (For example, from a CTU) to the 
MUX. 

Function Code 36B: Set Binary Length 

Function 36B sets the physical buffer length for binary type read requests. 
This information is normally provided by the driver from a user read (EXEC 
1) request, but it may be overridden. 



Function Code 37B: Set Read Type 

Function code 37B sends configuration information to the interface card for 
use in read (EXEC 1) operations. Under normal operation, this information 
is provided by the interface driver as directed by the function field bits 
10-6 of the EXEC request. 

This call provides the user with a mechanism to override the interface 
driver defined values or to configure a read operation on the card without 
executing a read request. This is useful in type-ahead initialization. If 
bit 7 in the driver configuration word (control 33B) is not set, the next 
read operation will reset the read type. See Table 2-2 for a description of 
the Set Read Type parameter. 

For example, to establish a read type with a buffer transfer on a carriage 
return for LU 1*1: 
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ICODE = 3 

ICNWD = 3700B+U1 

ITYPE = 100000B 

CALL EXEC (ICODE, ICNWD, ITYPE) 



OR 



CN,1*1,37B,100000B 



Table 2-2. Set Read Type (Function 37B) Parameter Description, 



Bit # Read Type 



15 
Ik 
13 
12 
11-10 



8 

7-0 



end transfer on a carriage return <CR> 
end transfer on a record separator <RS> 
end transfer on control-D 
end transfer on DC 2 

00 - End transfer based on bits 15 - 12 

01 - End transfer based on bits 15 - 12 

10 - End transfer on count using control function 36B 

11 - Reserved.* 

enables input data editing 
(backspace and delete) 

enables input data echoing 

reserved for future use, 
should be set to zero 



* If Bit 11 is set, a control 36B should also be issued 
to set the length. 
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Chapter 3 
Using the MUX 



This chapter describes the features of the HP 12792B Multiplexer. 
Type-ahead is explained, and the most commonly used type-ahead modes are 
covered. Error handling and failure analysis in user-written programs are 
also addressed. 



Normal Mode 



In the normal, non-type-ahead mode of operation, the subsystem will appear 
identical to other non-multiplexed RTE terminal drivers. when a port is 
inactive, the driver will set up a "read pending" on the terminal so that it 
will be informed when any key is struck. The appropriate action (system 
attention, program schedule, etc.) will then be taken. 



Type- Ahead 



Type-ahead is the ability of a system to accept data from the user's 
terminal or device before it is requested by the CPU. The MUX card is a 
buffered device and for each channel it is capable of holding up to two, 254 
byte buffers of text in on-board memory. 

An advantage of type-ahead is that applications programs can make the system 
appear more responsive to the user, increasing total (system plus human) 
throughput. This is done by having the application program prompt the user 
to respond while processing the previous input. By the time the user has 
finished typing, the system will have processed the last request and can 
begin on the next. As long as the processing takes less time than the 
typing, the user perceives instant response time. 

While in type-ahead mode, the driver leaves a read request pending on the 
card (not the EQT) at all times. This read allows the user to enter 
data into the card even though the system does not have a read pending. 
Upon receiving a record the card will interrupt the CPU, telling it that a 
buffer of data is available. If no request has been posted to that port, a 
flag is set in the status word and the driver returns to the system and 
waits. When a request is issued, the driver reads the data from the card 
and completes the user request. 



3-1 



Since keyboard characters are buffered on the card, system attention in 
type-ahead mode cannot be gained by striking a terminal key. The BREAK key, 
however, is not buffered and can be used to obtain system attention. 

Since multi-line type-ahead is possible, two different type-ahead modes are 
available. Full type-ahead, as described above, would cause successive read 
requests to fetch successive lines of text from the multiplexer card. This 
mode is useful for such tasks as text editing and using DBUGR. Typing can 
be done as far ahead of the data processing as allowed by available 
multiplexer buffer memory, up to and not exceeding two records. 

In situations where system response could radically alter a user's next 
command (FMGR error messages, for example) a full multi-line type-ahead may 
cause problems. The following will illustrate this problem: 

User types... ST,FILE,8 

while tape is moving, the user types: 

PU.FILE 

the tape runs out; the system downs the device 

The user hits the BREAK key, the system issues a prompt and a read, the 
system rather than FMGR reads the PU command from card buffer, and 
tries to execute the FMGR command. 

In the above example, the user merely gets back an "OP CODE ERR" from the 

system the first time the request for system attention is made. It is 

possible, however, for the commands stored on the card to have a disastrous 
effect on the system. 

The solution to the above problem is to configure the driver to cancel all 
card data upon receiving a BREAK interrupt (refer to control function 33B) . 
This preserves the multi-line type-ahead feature, and reduces the chance of 
data being read by the wrong process. 

If an analogous situation could occur for user written programs, another 
possible solution is for the user to issue a " "Flush Card Buffer" request 
(control request 26B.1) prior to any sensitive read request. This will 
clear the extra commands before they can be misread. 

Note that type-ahead is also useful in non-terminal device communication. 
The buffering on the card eliminates the need for stacking two or three 
class read requests on an LU to prevent data loss, thus reducing program 
size and complexity and the need for a large SAM (System Available Memory). 
Type-ahead scheduling can be used to invoke a data processing program. 



3-2 



When data is available on the multiplexer card and there is no pending 
request to accept it, a bit is set in the status word and program scheduling 
will be attempted. Should the user program decide it doesn't want the data, 
it can issue an input flush (control 26B) to remove the data. 



Program Scheduling 



Program scheduling is a mechanism whereby certain external events will cause 

the interface driver to schedule a program in the system. This program is 

given the address of EQT (Equipment Table) word H which provides adequate 
information to determine at which port the event occurred. 

Program scheduling is an optional feature which must be enabled to operate 
via a control request. Function code 20B enables the driver to schedule a 
program on interuupt and function code 21B disables it. The program to be 
scheduled can be specified at generation or through function code 27B. 
Function code 27B allows programmatic scheduling of MUX port programs where 
the address of the program's ID segment is stored as a parameter value in 
the call statement. This program will override any program for the port 
that was designated when the system was generated. 

There are several events that can cause an interrupt which will schedule the 
program for the MUX port as described below (refer to function code 33B, 
bits 13, 12): 

a. When the port has been set to "normal" mode it requires that either any 
character key or the BREAK key on a terminal keyboard is struck (the 
character struck will be ignored), or a character or BREAK is received 
from a device. 

b. When the port has been set to "type-ahead" mode it requires the receipt 
of a BREAK: to schedule the program because any characters received will 
be saved in the port's data buffers. 

c. The port can also be configured to schedule the program on receipt of a 
buffer of data from the device. This type-ahead with scheduling mode 
will also recognize the BREAK key. 

A program scheduled by one of the above events is run with the CPU's B 
register pointing to word-4 of the EQT entry that corresponds to the port 
upon which the event took place. Library functions EQLU-or TRMLU can be 
used by the program to recover the Logical Unit (LU) of that port. This LU 
can be used later to make I/O, function code, and status calls to that port. 
The library subroutine RMPAR can be used to recover EQT words 4 through 8. 
Note that both these routines require that the B register set by the driver 
remain intact. 
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The programs PRMPT and R$PN$ are used for terminal break-mode command 
processing, and are supplied with most RTE systems. These programs are an 
example of the use of program scheduling. 

In operation, PRMPT is the program which gets scheduled on interrupt from 
the terminal. When invoked it finds the LU of the interrupting port and 
writes the break-mode prompt to that LU. It then posts a class read against 
that port and schedules the program R$PN$. R$PN$, waiting on a class GET, 
receives a command from the user and executes it, returning to suspend on 
the GET call for the next command. 

User supplied programs may be written to process other schedule-driven 

applications. These programs may either be included as the program to be 

scheduled when the system is generated, or assigned on-line by a control 
request. 



Common Type-Ahead Modes 

Function code 33B allows the user to provide control requests for the driver 
responses by manipulating four fields to specify sixteen different 
type-ahead combinations. However, the four following combinations are 
sufficient for most user applications. If a specific application is 
desired, the user can design a mode by manipulating the control-request word 
bit fields using function code 33B. 

The common operating modes are: 

Normal Non-Type-Ahead Mode 

Full Type-Ahead Mode 

Type-Ahead with Flush on Break Mode 

Type-Ahead with Scheduling Mode 



Each mod* is summarized below along with the run string necessary to 
configure the user's terminal. Control requests and bit manipulation are 
covered in the Interface Driver section. 
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No Type- Ahead Mode 

No Type-Ahead Mode 

CN,0G,33B,012400B 



Control Parameters 



Control Request 



User's Terminal 



This will return the port to a standard RTE mode. This mode is commonly 
used in the WELCOM file so that the individual may later configure the port 
to a specific application. If a key is struck while executing in this mode 
and no request is pending on the terminal, the designated program will be 
scheduled. 



3-3.2 Full Type-Ahead Mode 



Full Type-Ahead Mode 



CN,0G,33B,022400B 



Control Parameters 



Control Request 



User's Terminal 

The type-ahead is a mode of operation enabling the interface to accept 
strings of data from terminal devices even though the system did not request 
any information. This information is stored in one of the two 254-byte 
receiving buffers for that port and remains buffered until a program reads 
the contents of the buffer. While in type-ahead the driver leaves a read 
pending on the interface, looking for a valid terminator. The terminator 
merely signals the interface driver that a complete record has been 
encountered, and the interface card will interrupt the CPU. 

In this mode, the only way to schedule the designated program is to strike 
the break key. Data resident on the card, if any, is not disturbed. 
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Type-Ahead With Scheduling Mode 

Type -Ahead with Scheduling Mode 



CN,0G,33B,02U1+00B 

Control Parameters 
Control Request 
User's Terminal 



This mode configures the interface driver responses to utilize the 
type-ahead mode. Scheduling will occur when an end-of -record is 
encountered. Depressing the Break Key will always schedule the designated 
program. Program specification is accomplished with control function 27 or, 
more commonly, it is specified at generation time. 



Type-Ahead With Flush On Break Mode 

Type-Ahead with Flush on Break Mode 



CN,0G,33B,023000B 



Control Parameters 



Control Request 



User's Terminal 

In this mode when the break key is struck, the interface driver will flush 
the contents of the input buffers and then the program designated by control 
function 27 is scheduled. This mode of operation is the preferred 
type-ahead mode because it reduces the possibility of having data misread. 
The user has the option of "erasing" the contents of the buffers just 
entered by hitting the break key or leaving the buffers alone allowing them 
to execute when the next read request reads them. 

NOTE: Flush on break may be used in conjunction with either full type-ahead 
or type -ahead with scheduling. 



3-6 



Update 1 



Error Recovery 

Dynamic status checking and I/O status checking allow the user to check on 
the status of a multiplexer port for normal processing and error checking. 
I/O status can provide the user with two of the device status words (EQT5 
and EQTM) and an LU status word. Dynamic status checking provides the user 
with the port's status and the length of any type-ahead data if present. 
Function code 6B is described in Chapter 2, User Interface. 

All errors associated with the Mux will appear as: 

- time outs 

- parity error or overflow 

Parity and overflow errors are indistinguishable. As soon as an error is 
encountered, the user's buffer is flushed. However, if a pending read or a 
time-out occurs, the status returned will indicate a parity/overflow error. 



I/O Status 



I/O Status 



The I/O status request, using a request code (ICODE) of 13, calls the RTE 
operating system to provide information contained in system tables. This 
EXEC call is not a call to the interface driver and therefore may not return 
the current status of the port. The LU number of the port must be specified 
in the control word (ICNWD). One additional parameter is required and two 
more are optional. One, two, or three words are returned to the user's 
program in the parameters passed. Table 3-1 lists the I/O status request 
returns. 

A sample calling sequence for LU 41 is shown below: 



ICODE = 13 
ICNWD = 41 
CALL EXEC( ICODE, ICNWD, ISTA1 , ISTA2, ISTA3) 
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When the call completes, the variables 1STA1 , ISTA2, and ISTA3 contain the 
I/O status as shown in Table 3-1. ISTA1 is the status word (EQT5) and ISTA2 
is also a status word (EQT4). 



Failure Analysis 



For failure analysis it is important to note that all errors appear as time 



outs, parity or overflow errors. Current 
not produce the following error message, 
use the EXIT command described in Chapter 
message displayed at the system console. 

I/O XX L #x E #Y S #z 



HP supplied device drivers will 

User written device drivers may 

4 to have the following error 



XX 



NR 
TO 
PE 
etc, 



as specified by device driver 



In the above example x, y, and z are the Logical Unit number, EQT number, 

and subchannel number respectively. If a device is down, any I/O control 
request will wait for the operator to "UP" the EQT number. 

For time-outs it may be that a simple time-out has occurred, indicating the 

operator was too slow in responding to a read request. In this case, retry 
the request. 

If the device is not downed, control will return to the user program on 

error and the user program should be structured to check for errors and 

process accordingly. The "I/O Status" request can be used to obtain the 
status to test for various conditions. 



Read Errors 



If the last command issued was a read, a parity error or data overrun may 
have occurred. Data Overrun indicates the multiplexer maximum throughput 
rate has been exceeded and data on the LU with the overflow bit set was 
lost. These errors are only detectable on a read operation. 
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Table 3-1. I/O Status-Request Returns 



Word 



ISTA1 



Bits 



15-lU 



13-8 

7-0 
7 
6 

5 
k 

3 



1 




Description 



I/O controller availability indicator: 

00 = Available for use 

01 = EQT disabled (down) 
10 = Device busy 

Equipment Type code 

Status : 1 = 

Reserved for future use, always zero. 

Break Key hit 

Control D entered on the last request (EOT) 

Modem line down 

Parity error or overflow detected on the last 

request 
Type-ahead data available, control function 6B 

will return the length of type -ahead data in 

the B-Register 
Program schedule enabled 
Last request timed out 



ISTA2 15 Reserved for future use, always zero 

lU 1 = Automatic output buffering enabled 

13 1 = Driver to process power fail (always 1) 

12 1 = Driver to process time-out (always 1) 

11 System communication flag 

10-6 Last subchannel addressed 

5-0 Select code of the Multiplexer Card 



ISTA3 Logical Unit Status: 

15 1 = LU down, = LU up 

lU-5 Reserved for future use, should always be zero 

k-0 EQT subchannel associated with the LU number 
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Chapter 4 
Device Driver Writing 



This chapter explains the writing and use of device drivers that can be 
called by the 12792B Multiplexer Interface Driver, DVMOO. The basic 
philosophy of using device drivers is explained to give the user a better 
understanding of the steps involved. 



Device Driver/Interface Driver Concept 

An interface driver is a standard RTE driver that converts user EXEC 
requests for input, output, and control into a sequence of assembly level 
instructions which control and pass data to an interface card through the 
I/O backplane of an HP-1000 computer. The interface driver need know 
nothing about the device that is the eventual source or destination for the 
data; the interface driver only communicates with the interface. The device 
driver modifies user requests to make them compatible with the device. The 
device driver is a subroutine that is called by the interface driver to 
examine and modify user requests. 



Reasons For Device Driver/Interface Driver Use 



The device driver/interface driver concept offers several advantages over 
the conventional monolithic driver. The use of device drivers allows 
flexibility for system designers and users. Many different types of 
equipment may be controlled by a single type of interface as long as they 
are electrically compatible and use the same basic line protocol. For 
example, any RS-232-C (electrical specification) , asynchronous (basic line 
protocol) device may be controlled by the 12792B MUX interface. Individual 
device drivers for each of these devices may be easily written without 
knowledge of the I/O card/backplane interface. New devices may be added to 
a system without undertaking the monumental task of writing an entirely new 
driver. The system programmer need only write a subroutine to add the 
required character sequences to the user data to control the new device. 

Differences between devices may be made transparent to user programs. 
Applications programmers need only concern themselves with reading or 
writing data to a "standard" device while the device driver takes care of 
the control needed for the "exotic" device the program is actually 
communicating with. 
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Some devices may be customized by using different device drivers for 
different tasks. Printing terminals may be made to look like line printers 
to the user program by writing a device driver to translate column one 
carriage control into the proper escape sequences for the terminal. A 
different device driver may then be used when an interactive terminal is 
desired. These various device drivers may be dynamically switched in and 
out by the user program or by the system manager when required. 

A single driver written to control a large number of different devices 
through a common type of interface would be very large. Requiring the use 
of this driver would penalize users who only need a few of these devices. 
By using device drivers a system manager need only include the driver code 
needed for the devices on the system, thus saving space for other uses. 



Interface Tasks 



To write efficient device drivers it helps to have an understanding of the 
responsibilities of the other components in the I/O interfacing subsystem. 
In the HP 12792B Multiplexer Subsystem the HP 1279-2B MUX interface card is 
primarily responsible for sending and receiving characters on the RS-232-C 
line and for handling line protocol. When enabled to do so, it handles the 
ENQ/ACK line protocol to prevent terminal buffer overruns; it transmits and 
receives the characters to and from the terminal at the baud rate for which 
it has been set by the driver; and it automatically packs the eight-bit 
characters into 16-bit data words for efficient DMA transfer to the 
computer, or unpacks the 16- bit words into eight-bit bytes for the 
terminal. The card treats the parity bit as described in the Interface 
Support statement in the Multiplexer Configuration Guide, and notifies the 
driver when incorrect parity has been received. 



Interface Driver Tasks 



Interface Control 



The interface driver DVMOO for the 12792B multiplexer subsystem is 
responsible for controlling the MUX interface card via assembly level I/O 
instructions to the computer I/O backplane. The driver interprets user 
requests to properly initialize the card for baud rate, parity, character 
length, number of stop bits, etc. Also it initializes and starts DMA 
transfers between the computer memory and the card. 
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Operating System Interface 



The interface driver receives EXEC level user requests from the RTE 
operating system and passes them to the device driver for further 
processing. The interface driver processes requests from the device driver, 
returning to the device driver on each request completion. The interface 
driver requests a DMA channel from the RTE operating system when a data 
transfer is required either to send data to the card or receive data from 
the card. When the device driver informs the interface driver that the user 
request is complete, the interface driver returns to RTE with the correct 
device status and transmission log or error code in the A and B Registers. 



Device Driver Tasks 



The device driver is entered on each new user request and on completion of 
each device driver request. The device driver may do further checking on 
request legality. If the device requires a special sequence of characters 
prior to receiving or sending the user data, the device driver should format 
the characters into a buffer and send them to the device via a device driver 
request to the interface driver. When the user request is to be processed 
the device driver tells the interface driver to start the request currently 
in the EQT. When the entire request has completed, the device driver places 
the correct status in the EQT and the transmission log in the B Register, 
and then informs the interface driver that the request is complete. 



HP Implementations Of Device Drivers 

There are two examples of device driver applications that Hewlett-Packard 
has implemented as part of the HP 12792B Multiplexer subsystem. 

Lineprinter Device Driver DDV12 

Device driver DDV12 makes HP 2631/2635/7310 printers look like typical line 
printers to user programs. These devices use escape sequences and control 
characters for carriage control while standard line printers interpret the 
first character of each line as a carriage control character. The DDV12 
device driver examines the user's first character and sends the proper 
control character sequence to the printer. The first character is then 
stripped from the data and the data is sent to the printer. The device 
driver also changes the driver type in the EQT to type 12 for lineprinters. 
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Block Mode Terminal Device Driver DDV05 



The device driver DDV05 allows utilization of the block mode read 
capabilities of an HP 264X or 262X terminal. The first time a read request 
is made to the terminal its status is read to determine whether it is in 
block or character mode. When a user read request is made the device driver 
first issues a write to the interface driver to send a DC1 to the terminal. 
If the terminal is in block mode the device driver issues a read to the 
interface driver and examines the first returned character. If the 
character is a DC2 the device driver knows that the terminal is in block 
mode and trying to send data to the interface. A read is then issued for 
the user buffer length with echo and character editing turned off. If the 
returned character is not a DC2, the user program had probably issued a 
program enabled block read (escape lower case d) and the program's data is 
in the buffer just read. 

If the terminal is in character mode, the user's request is executed "as is" 
after the DC1 is sent (to enable the sof tkeys) . 



Device Driver Interface 



An uncomplicated device-driver/interface-driver interface is provided making 
it easy for systems programmers to write their own device drivers. All that 
is required beyond the information given in this chapter is a basic 
familiarity with the flow of I/O requests in RTE and a thorough knowledge of 
the particular device that is being communicated with. 



Device Drivers For HP 12792B Multiplexer 

The following points should be kept in mind when writing device drivers for 
the HP 12792B Multiplexer subsystem. First, all read, write, and control 
requests are passed to the device driver by the interface driver for 
modification before they are sent to the interface card. The device driver 
only has to make read, write, or control requests to the interface driver; 
the device driver does not issue I/O instructions to the interface card. 
The device driver requests are at the EXEC level, that is, a request word 
(control word as defined for EQT word 6) buffer address and length, or 
optional control request parameters are passed to the interface driver. A 
device driver will typically make several of these requests for each user 
EXEC request. After each device driver request completes the interface 
driver will return to the device driver for the next request. It is up to 
the device driver to tell the interface driver when the original user 
request is complete. The device driver and interface driver pass parameters 
back and forth between each other using the A and B Registers and the 
portion of the EQT extent defined as the Device Driver EQT Extent. 
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Restrictions And Requirements 

When a device driver issues read or write requests the data buffer must be 
either within the device driver or in the same map as the user request 
buffer. If the user request is unbuffered the user request buffer is in the 
user map. If the user request is buffered, class I/O, REIO (re-entrant 
I/O), or $XSIO (system I/O) the user request buffer is in the system map. 

All requests are passed to the device driver prior to checking by the 
interface driver. Device drivers should check only for control requests 
that are defined for the device driver. Any unrecognized control requests 
should be passed on to the interface driver with a command to execute the 
request. 



System Abort Requests 

A system abort request may be issued to the interface driver at any time if 
the user program currently doing I/O is aborted for any reason. The device 
driver may be entered with the system abort either as a new user request or 
as a continuation request. If the device driver is entered as a new user 
request with the system abort request, the device driver should treat it as 
any unknown control request and pass it back to the interface driver. 

However, if the device driver is entered as a continuation with the system 
abort two problems may occur. If the device driver does not check for the 
system abort on a continuation entry and subsequently issues a read or write 
request to the user buffer, the buffer area may have been re-allocated for 
other uses. Program corruption and system or subsystem crashes may occur. 
It is also possible to leave the device in an unknown state if an expected 
user buffer is not written to the device. If this is a problem with a 
device, the device driver should check for system abort requests and reset 
the device to a known state. 

In all cases the device driver should check for a system abort request prior 
to issuing an I/O request to the user buffer area. 

To test for a device driver system abort request check the contents of EQT 
word 6 or word 2 of the extent for a 100003 octal ($XSI0 control zero 
request). The above tests are necessary if the device driver issues its own 
read or write to or from the user buffer area on a continuation entry. If 
the device driver is simply trying to execute the user's original request by 
leaving it in the device driver EQT extent word 2, the test for system abort 
request is not necessary. In this case the contents of device driver EQT 
extent word 2 are changed to a control zero at the same time as EQT word 6. 



4-5 



Interface Definitions 

Entry to the Device Driver 

On entry to the device driver the following parameter locations are defined: 

A Register, Bit 15: 1 = initial entry on a new user request 

= continuation entry, signifying a previous 
device driver request is complete 

Bits 14-0: address of device driver EQT extent 
(defined below) 

B Register: Previous device driver request transmission log, 
if any 

The device driver EQT extent words 2-4 are set to the current user 
request definition. These three words are copied from EQT words 6-8 on 
each (new or continuation) entry to the device driver. See the expanded 
definitions of the EQT words below. 

Base page locations 1660 through 1672 are the addresses of the current 
EQT words 1 though 11 and base page locations 1771 through 1774 are the 
addresses of EQT words 12 through 15. 

On each entry EQT words 4-10 and 14 are defined per the RTE definitions 
(expanded below). EQT words 9 and 10 (READ/WRITE optional parameters) 
are defined per RTE on new request entries only (A Register bit 15 = 1). 
However, they are not defined on the subsequent continuation entries. 
If their contents are required by the device driver on subsequent 
entries, they should be saved in the device driver EQT extent on the new 
request entry. 



Return To The Interface Driver 



On return to the interface driver the device driver must insure that the 
proper parameters are passed back to the interface driver. The device 
driver must differentiate between new user request entries and continuation 
entries as the parameters returned to the interface driver are different for 
each case. Also, the device driver must tell the interface driver when the 
original user request is complete and set up the correct transmission log 
and status indications for the calling program. 

On return to the interface driver the following parameter locations are 
defined: 
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A Register, Bits 15-3: Function modifier 
Bits 2-0: Exit command 

B Register: Request timer, or user transmission log 

EOT 5, Bits 7-0: Status for user 

Device driver EQT extent, 

word 1 : Physical record length in characters for read 
requests if different from user buffer length 

word 2: Request word as defined for EQT word 6 except 

that bits 15-11 are not defined and should be 
zero 

word 3: Request buffer address 

word 4: Request buffer length (positive number of words 

or negative number of characters) 



Return To Interface Driver — Device Driver EQT Extent 

The physical record length (device driver EQT extent word 1) is used to 
prepare the 12792B interface card for binary data read requests where the 
device does not terminate the record with a special character such as 
carriage return. The physical record length must be a positive number of 
characters. If this parameter is not set, it defaults to the user buffer 
length. 

Words 2-4 of the device driver EQT extent may be changed by the device 
driver to cause the interface driver to execute some other request, or they 
may remain unmodified causing the interface driver to perform the initial 
user request. Remember that on each entry words 2-4 of the device driver 
EQT extent are restored to the original user request copied from EQT words 
6-8. 



Return To Interface Driver — A- Register 

Exit Command 



On return to the interface driver from the device driver the A Register bits 
2-0 must be set up with the exit command. The exit command definition is 
similar to the RTE definition for the A Register for a standard driver on 
return to RTE. The exit command definition is as follows: 
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Exit command if entered with a new user request 
(A Register bit 15 = 1 on entry) 

= start request in device driver extent words 2-4; 

B Register = time out value (-10s ms) 

1 = user I/O request is illegal, give 1007 error 

2 = user control request is illegal, ignore it 

3 = I/O device not ready, down it and print IONR message 

4 = user request completed (immediate completion); 

B Register = transmission log 

5 = start request (same as 0) 

Exit command if entered after completion of a device driver 
request (A Register bit 15 equals on entry) 

= user request is complete; B Register = transmission log 

1 = I/O device not ready, down it and give IONR message 

2 = end of transmission (EOT) reached, down device and 

give IOET message 

3 = parity error, down device and give IOPE message 

4 = device time out, down device and give I0T0 message 

5 = new request in device driver EQT extent words 2-4; 

B Register = time out value (-10s ms) 



Function Modifier 



Error type exit commands (new request 1, 2, and 3 or continuation entry 1, 
2, 3, and 4) are simply passed to RTE in the A Register by the interface 
driver. Action taken (program abort, print error message, etc.) is 
determined by RTE the same as for any standard driver. 

For exit commands that initiate another device driver request (new request 
exit command equals or 5, continuation entry exit command = 5) a function 
modifier may be placed in the A Register bits 15-3 to override and expand 
the normal request function code contained in the device driver EQT extent 
word 2, bits 10-6. Function modifiers are defined for read and write 
operations. Write function modifiers contain read modification fields and 
can be used to define the function modification for the next read or series 
of read operations. The write function modifier bit fields are defined as 
follows: 



A Register bits 15-3 

Bit 15: end transfer on carriage return (CR) 

14: end transfer on record separator (RS) 

1 3: end transfer on end of tape (EOT, control D) 

12: end transfer on (DC2) 

11: end transfer on specified character count 

10: enable end on character specified in bits 15-12 
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9: enable character editing (backspace, delete, etc) 

8: echo received characters 

7: not defined, should be 

6: not defined, should be 

5: disable ENQ/ACK handshake this transfer only 

4: add CR/LF to buffer if last character is not an 

underline (137 octal) 
3: use write overrides in bits 7-4, if bit 3 is 0, 

bits 7-4 should be 

If bits 7-3 are zero (do not override) the write is configured by bits 10-6 
in the device driver EQT extent word 2. These bits are defined as bits 10-6 
in EQT word 6 and the ICNWD description in the EXEC write section of this 
manual. 

The read related fields in the write function modifier (bits 15-8) will 
configure the card for any subsequent read operations. This eliminates the 
"window" between writing and reading so that if the write triggers a 
response from the device no data will be lost. 

If enable end on character (bit 10) is set, one or more of bits 15-12 must 
be set. Reads will complete on reception of any one of the specified 
characters. If bit 10 is clear, bits 15-12 should be zero. If end on count 
(bit 11) is set, the physical record length in device driver EQT extent word 
1 should be set to a positive number of characters. If bit 11 is set, the 
end on character bits 15-12 and 10 are ignored. Only one of bits 10,11 
should be set. 

For read functions the modifier bit fields are defined as follows: 

A Register bits 15-8,3 

Bit 15: end transfer on carriage return (CR) 

14: end transfer on record separator (RS) 

13: end transfer on end of tape (EOT, control D) 

12: end transfer on (DC2) 

11: end transfer on specified character count 

10: enable end on character specified in bits 15-12 

9: enable character editing (backspace, delete, etc) 

8: echo received characters 

7-4: reserved for future use, should be zero 

3: use current card configuration 

If enable end on character (bit 10) is set, one or more of bits 15-12 must 
be set. Reads will complete on reception of any one of the specified 
characters. If bit 10 is clear, bits 15-12 should be zero. If end on count 
(bit 11) is set, the physical record length in device driver EQT extent word 
1 should be set to a positive number of characters. 

If bits 15-3 are all zero the read configuration will be determined from the 
control word bits (10-6) in the device driver EQT extent word 2. These bits 
are defined as in EQT word 6 and the ICNWD described in the EXEC read 
section of this manual. Bit 9 of the EXEC request (EQT extent word 2) is 
always used and must be valid. If bit 3 is set bits 15-4 should be zero. 
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Return To Interface Driver — B-Register 

On return to the interface driver the device driver should set the 
B register to be either the transmission log, or the device time out value. 
If the initial user request is complete, the B register should contain the 
transmission log to be returned to the user program. Transmission logs for 
each device driver operation are returned to the device driver in the 
B register by the interface driver on each continuation entry. The device 
driver may save one or more of these to return, or the device driver may 
return any meaningful number. Convention requires that the transmission log 
be a positive number, either a number of words if the initial user request 
specified words (EQT word 8 is positive) or a number of characters if 
characters were initially specified (EQT word 8 is negative). 

If a new device driver request is to be initiated (exit command = 5 on 
continuation, or 5 or on initial entry) the B register should contain the 
request time out value. This value will be a negative number of time base 
ticks (10s of milliseconds). If the device driver needs to use the system 
defined time out for the device, EQT word 14 should be copied into the 
B Register. 



Return To Interface Driver — EQT Entries 

As a general rule it is not advisable for the device driver to modify the 
EQT, except for the area defined as the device driver EQT extent. However 
some EQT areas are routinely modified by device drivers. In EQT word 5 the 
equipment type (bits 13-8) should be modified on the first entry to a device 
driver to reflect the device type the device driver is emulating. On each 
completion exit (new request exit command equals 4, or continuation entry 
exit command equals 0) the status field in EQT word 5, bits 7-0 should be 
updated to return status to the user. This field should be the same as is 
defined for the device type the device driver is emulating. 

After the user's request has been processed, if further interaction with the 
interface driver is required EQT words 7 and 8 are available as convenient 
temporary storage areas. It is common to store the transmission log in EQT 
word 8 in these cases. Words 9 and 10 are used by the interface driver for 
temporary storage and should not be modified by the device driver. 



Selected EQT Definitions And Uses 

EOT Word 4 — Subchannel EQT word 4 bits 10-6 contain the currently 

addressed subchannel. This information is required by device 

drivers that perform different tasks for different sub- 
channels. 
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EQT Word 5 — Equipment Type Code and Status 

EQT word 5 bits 13-8 contain the equipment type code as spec- 
ified by the driver name at generation. The 12792B multiplexer 
interface driver is DVMOO, and so the type code is 00. Device 
drivers that emulate devices should use a type code correspond- 
ing to the device they are emulating. On first entry the device 
driver should change the type code in the EQT table. The type 
codes and devices they represent are given below: 

00 to 07 = terminals or paper tape devices 

00 = teleprinter or keyboard control device 

01 = photoreader 

02 = paper tape punch 

05 = intelligent terminal devices generally having block 

mode capability (HP 264x and 262x terminals) 
07 = multipoint devices 
10 to 17 = other unit record devices 

10 = plotters (Calcomp or HP 7210) 

10 = plotters (Calcomp or HP 7210) 

1 1 = card readers 

12 = line printers 

1 3 = TV monitor 

1 5 = mark sense card readers 
20 to 35 = mag tape or mass storage devices 

23 = 9 track mag tape 

24 = 7 track mag tape 

30 = fixed head disc 

31 = 7900 moving head disc 

32 = 7905/6/20/25 moving head disc 

33 = flexible disc drives 

36 = writable control store (microcode execution space) 

37 = HPIB Interface 

47 = Multidrop FDL interface 

EQT word 5 bits 7-0 contain the device status of the 12792B Multiplexer on 
each entry to the device driver. This status is defined as follows: 

Bit 7 Time out, if the driver was entered on a time out this bit will 
be set on entry to the device driver. 

Bit 6 Break, if the 12792B Multiplexer card received a break 
character from the terminal during the last operation this bit 
will be set. 

Bit 5 EOT, The End Of Tape bit will be set if an EOT (004 octal) was 
received during the last read. 

Bit 4 Modem line is down. 

Bit 3 PE/OV, the Parity Error/Overflow bit will be set if either one 
of these conditions occurred on the last read. 
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Bit 2 Type-ahead data, this bit will be set if type-ahead data is 
available on the card. 

Bit 1 Schedule, this bit indicates that program scheduling on 
unsolicited interrupt has been enabled (interface driver 
control function 20B) . 

Bit Bit is not currently used. 

The above definitions apply whenever the device driver is entered from the 
interface driver. The device driver is free to change any of the status 
bits if emulation of other driver types is desired. On a user request 
complete exit from the device driver the status bits (EQT word 5) will be 
passed to the user program in the A Register. 

EQT word 6 and device driver EQT extent word 2 contain the current request 
word which is defined as follows: 

Bits 15-14 Request type: 

00 = standard user request 

01 = automatic buffered user request (request 

buffer is in system available memory) 

10 = a system request ($XSI0) 

11 = user Class I/O request (request buffer is 

in system available memory). 

Bits 15-14 are only defined in EQT word 6. They are undefined in the 
device driver EQT extent word 2 and should be set to zero if the 
device driver modifies this word. 

Bit 12 Z-bit indicates a second buffer is available on a read 

or write. If set, EQT word 9 "Stains the address of 
the buffer and EQT word 10 contains the length. If the 
Z-bit is clear, EQT words 9 and 10 contain 1 word 
optional parameters. 

In the 12792B Multiplexer subsystem, the interface driver does not use 
the double buffering feature, it is therefore available to the device 
driver for use. 

Bits 10-6 Subf unction, as defined in the EXEC request 

section of this manual for the EXEC control 
word. 

Bits 1-0 Function: 

01 = read request 

10 = write request 

11 = control request. 

Bits 13,11 These bits are undefined and should be set to 
and zero if the device driver modifies the request 
5-2 in the device driver EQT extent word 2. 
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EQT word 7 and device driver EQT extent word 3 is the user buffer address. 
The interface/device driver is always entered in the same map as the user 
buffer, so the user buffer address is in the current map. 

EQT word 8 and device driver EQT extent word 4 is the user buffer length. 
The length is either a positive number of words or a negative number of 
characters. 

EQT word 9 is an optional parameter. If the Z-bit (EQT word 6 bit 12) is 
set EQT word 9 is the address of a secondary user buffer which is in the 
same map as the primary user buffer. If the Z-bit is clear, EQT word 9 
contains the optional parameter or zero if no parameter was passed. 

EQT word 10 is an optional parameter. If the Z-bit is set, EQT word 10 is 
the length of the secondary user buffer. It is a positive number of words, 
or a negative number of characters. If the Z-bit is clear, EQT word 10 
contains the second optional parameter or zero if a second optional 
parameter was not passed. 

Both EQT words 9 and 10 are only available to the device driver on a new 
request entry. These words must be saved in the device driver EQT extent if 
they are required later by the device driver. 

EQT word 14 contains the system defined time-out reset value for the device 
(a negative number of time base ticks at multiples of 10 milliseconds). 
This value is set by the system at generation or by the system TO command, 
or by the interface driver by a control request of 22B. This word may also 
be set directly by the device driver if desired. 

EQT word 15 contains the time out clock count down counter. This word is 
setup by the interface driver prior to returning *o the system. This word 
should not be modified by the device driver. On any device driver request 
to the interface driver the time out count for EQT 15 should be passed in 
the B Register. The value should be a negative number in multiples of 10 
milliseconds. If the system defined time out is to be used, the device 
driver must pass the contents of EQT word 14 to the interface driver in the 
B Register. 



Device Driver Address Table 



The interface driver uses a device driver address table to find the correct 
device driver when the device driver is selected with a control request of 
33B. The device drivers are selected by numbers which are determined by 
their positions in the device driver address table. Each device driver to 
be used '1th the interface driver must have an entry in the device driver 
address table To add device drivers to the device driver address table, 
the user must create his own table. 

The device driver address table should have the following format: 
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NAM $DVTB,8 DEVICE DRIVER ADDRESS TABLE 

ENT $DVTB 

EXT DVNM1, . ...DVNMn 

* 

* DEVICE DRIVER ADDRESS TABLE 

* 

$DVTB DEC n NUMBER OF ENTRIES IN TABLE 

DEF DVNM1+0 ADDRESS OF DEVICE DRIVER 2 
DEF +0 3 



DEF DVNMn+O ADDRESS OF DEVICE DRIVER n+1 
END 

The names of the device drivers may be any valid label, as long as they do 
not conflict with any other symbol in the system. Note that the first 
device driver in the table is selected by a control request of 33B to use 
device driver number two. This is because the value zero is reserved for 
"no change", and one is used for the default device driver. Since the 
device driver number field is four bits wide, the user is able to include 
the default and up to 1 4 other device drivers in the system. 



Location And Size Of Device Drivers 



Since the device driver address table and device drivers themselves are 
called directly by the interface driver, they must be resident within the 
same map. This poses a few restrictions on the number and location of these 
modules. 

The interface driver requires approximately 1400 words of memory, so up to 
600 words are left in a standard two page driver partition for the device 
driver address table and the device drivers. If this is not enough room 
either the driver partition can be changed to three or more pages, or one or 
more device drivers and the table may be relocated into Table Area I. If 
$DVTB is relocated into Table Area I, all device drivers will be forced to 
Table Area I. The disadvantages are that the user available space in the 
system is reduced. If the driver partition size is increased, the size of 
the largest available user partition is reduced by an equal amount, and the 
size change must be an incremental number of pages. If the modules are 
relocated in Table Area I, the actual space used may not take away from user 
space unless a page boundary is crossed, in which case a page will be taken 
away from the largest available user partition. Device drivers relocated in 
Table Area I will take space otherwise used as System Available Memory. In 
the RTE-IVB operating system, only these two methods of gaining space for 
device drivers will guarantee that the device driver and interface driver 
will be in the same map and be mapped properly to handle all user requests. 
The interface driver and device drivers and table could be all relocated 
into the system driver area (SDA). More space is available to users, but 
large background programs will not be able to make unbuffered requests to 
the driver. 



4-14 



Case Study: A Device Driver Writing Example 

The following is an example of device driver writing that illustrates some 
of the problems, solutions, and steps involved in writing a typical device 
driver. The device driver in this example is written to make a terminal 
look like two separate terminals, sharing the keyboard, and splitting the 
screen into two separate areas. 



Task Definition 

The tasks involved in interfacing with a device using a device driver should 
be clearly defined and broken down into a sequence of logical steps. In 
this example the object is to make an HP 26XX terminal appear as two 
terminals for read and write requests. Requests made to an LU defined as an 
EQT subchannel will go to the left half of the terminal display, and 
requests to subchannel 1 will go to the right half of the display. 

Three major tasks are defined for the device driver while the interface 
driver handles the user's actual read or write request. The three tasks all 
involve sending specific character sequences to the terminal for 
initialization in a classic device driver application. 



Margin Set Up 

The first task is to set the left and right margins on the terminal to keep 
the following text on the respective side of the screen. Upon determination 
of the subchannel for each new user request the device driver sends the 
escape sequence to set the left and right margin at predetermined columns on 
the terminal screen. Due to terminal idiosyncrasies the left margin must be 
set first for subchannel (left side) and the right margin must be set 
first for subchannel 1 (right side) . 

Cursor Position 



The second major task is to position the cursor so that the subsequent read 
or write operations will appear at the correct place on the screen. The 
escape sequence to position the cursor is formatted with the correct cursor 
position for the left or right side of the screen. The device driver keeps 
track of the current cursor position for each side in the device driver EQT 
extent. Once the request buffer is formatted with the correct cursor 
position the device driver passes it to the interface driver as a device 
driver request. 
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Cursor Tracking 

The third major task for the device driver is to find out where the user's 
request has left the cursor for the side of the screen that was just 
addressed. To do this the device driver writes a request for a cursor 
position sense to the terminal and then reads back the result. The 
resulting cursor position is separated from the escape sequence that 
precedes it and stored away in the device driver EQT extent for the 
subchannel that is addressed. 



Minor Tasks 

Additionally, in an effort to reduce overhead, the device driver is written 
to not set the margins or position the cursor when the subchannel addressed 
is the same as the previous subchannel. It is assumed that the cursor and 
margins will remain in position between sequential requests to the 
subchannel. In order to implement this step the device driver saves the 
last addressed subchannel in the device driver EQT extent. 

Finally the device driver patches the equipment type code into EQT word 5. 
This patch will take place only the first time the device driver is accessed 
for any particular EQT. Since either subchannel most closely resembled type 
00 devices to the user the equipment type used is 00. This step is included 
for illustration only. When any "Select New Device Driver" request is made 
(CN,LU,33B,XXXXXn where bits 3-0 = 0) the driver is reset to 00. 



Device Driver Operation 

Functionally the device driver makes a series of tests on each entry to 
determine the action required. Processing a user request is a sequence of 
actions that generally fall in the following order: 

1. Position left or right margin 

2. Set margin 

3. Position other margin 

4. Set margin 

5. Position cursor 

6. Perform user request 

7. Request cursor position 

8. Read cursor position 

9. Save cursor position 

Each action is handled by a separate routine that saves the address of the 
next routine in the device driver EQT extent so that execution moves in a 
step by step fashion on each continuation entry to the device driver. 
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Operation Flow 



Figure 4-1 shows the complete device driver flowchart. 
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Figure 4-1. Device Driver Flow Chart 
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Figure 4-1 (cont'd). Device Driver Flow Chart 
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Set Up Device Driver EQT Extent Pointers 



On each entry to the device driver the device driver EQT extent addresses 
are stored into a table in the device driver. On each entry the A register 
contains the first device driver EQT extent address and bit 15 indicates new 
or continuation entry. Bit 15 is saved for later testing and stripped from 
the address before the addresses of the device driver extent are saved. 



DDSOO NOP 


DEVICE DRIVER ENTRY POINT 


STB TEMP 


SAVE B TEMPORARILY 


CLE 


SAVE A[15] 


ELA.RAR 


AND CLEAR IT 


LDB DEXAD 


ADDRESS OF TABLE 


LDX DM15 

* 


DECIMAL MINUS 15 


» CREATE TABLE OF DD 
* 


EXTENT ADDRESSES 


DEXLP STA B,I 


A CONTAINS ADDRESS OF DD EXTENT WORD 


INA 


B CONTAINS ADDRESS IN TABLE 


INB 


X CONTAINS COUNT DOWN 


ISX 




JMP DEXLP 





DEXAD DEF DEX01 
DEX01 NOP 
DEX02 NOP 



ADDRESS OF TABLE 

ADDRESS OF FIRST DD EXTENT WORD 



DEX15 NOP 



ADDRESS OF DD EXTENT WORD 15 



After the initial setup is done on each entry the device driver then tests 
the bit that indicates a new request entry that was saved in the E register. 
Continuation entries go the next routine to be executed whose address is 
always saved in the device driver EQT extent word 13. If it is not a 
continuation entry the device driver tests to see if it is the first ever 
entry for the EQT. Device driver EQT extension word 15 contains an ASCII 
"SO" if this is not the first ever entry. 

EQT Setup On First Entry 

On the first entry for any EQT the starting cursor positions for the left 
and right sides of the screen are established. The cursor positions are 
stored in ASCII format in the device driver EQT extent words 5 - 12. The 
starting positions, upper left corner of each screen, are hard coded in 
ASCII in the driver: 
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LDA ASO 
STA DEX15.I 

JSB .CFER 
DEF DEX05.I 
DEF SORC 
JSB .CFER 
DEF DEX09.I 
DEF S1RC 

LDA EQT5.I 
AND TMASK 
STA EQT5.I 



GET THE ASCII "SO" 

SAVE IT TO INDICATE NOT FIRST ACCESS 

MOVE FOUR WORDS OF CURSOR POSITION 

TO THE DD EXTENT 

FROM THE DEFINITION LOCATION 

MOVE FOUR WORDS FOR THE OTHER CURSOR 

TO THE DD EXTENT 

FROM THE DEFINITION LOCATION 

GET THE EQT ENTRY WITH EQUIP TYPE 
(14037B) MAKE THE TYPE 00 
SAVE IT 



EQT5 EQU 1644B 
SORC ASC 4,000r000C 
S1RC ASC 4,000r042C 



STARTING ROW & COLUMN SUBCHANNEL 
STARTING ROW & COLUMN SUBCHANNEL 1 



Subchannel Determination 

On a new request entry the device driver determines what subchannel the 
request is addressed to. The subchannel is in the EQT word 4 bits 10-6. 
The subroutine GTSCH gets the subchannel and returns it in the A register. 



GTSCH 



NOP 

LDA EQT4.I 

AND B3.7K 

ALF.ALF 

RAL.RAL 

JMP GTSCH, I 



GET FROM EQT WORD 4 

(3700B) ONLY LOOK AT THE SUBCHANNEL BITS 

POSITION TO RIGHT 
RETURN 



EQT4 EQU 1663B 

Once the subchannel has been determined the device driver must save it in 
the device driver EQT extent and then go set the left or right margin. Note 
that although the driver specifies subchannel or 1 it will use any even 
subchannel as the left side or any odd subchannel as the right side. 



JSB GTSCH 

STA DEX14.I 

SLA 

JMP RMPOS.I 

JMP LMPOS.I 



GO GET THE SUBCHANNEL FROM THE EQT 

SAVE IT IN DD EXTENT WORD 14 

ODD OR EVEN? 

ODD — DO RIGHT FIRST 

EVEN — DO LEFT FIRST 



Output a Setup String to the Terminal 



The device driver routines to output various strings of characters that set 
up the terminal are basically the same. They place the request in device 
driver EQT extent words 2-4 and exit through a common return routine. 
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Device driver extent word 2 is set up with a read or write request code, 
word 3 with a buffer address inside the device driver, and word 4 is set up 
with the buffer length. 



• POSITION 


CURSOR F 


LMPOS 


DEF 


»+1 




LDA 


BNWT 




STA 


DEX02.I 




LDB 


DEX14.I 




LDA 


LMPA 




SLB 






INA 






LDA 


A, I 




STA 


DEX03.I 




LDA 


CMLNG 




STA 


DEX04.I 




LDB 


LMSET 




LDA 


MODX1 




JMP 

• 


CRTN 


BNWT 


• 

OCT 


000102 


LMPA 


DEF 


LMPAD 


LMPAD 


DEF 


LMPAO 




DEF 


LMPA1 


LMPAO 


OCT 


15446 




ASC 


3, oooc 


LMPA1 


OCT 


15446 




ASC 


3, 042C 


CMLNG 


DEC 


4 


MODX1 


OCT 


102005 


* 






• 







ADDRESS OF ROUTINE 

GET THE CONTROL WORD FOR WRITE W/O CRLF 

PUT INTO DD EXTENT 

GET THE SUBCHANNEL NUMBER 

GET THE LEFT MARGIN POSITION ADDRESS POINTER 

TEST ON SUBCHANNEL 

ODD — USE THE OTHER ONE 

GET THE ADDRESS OF THE CHARACTER STRING 

PUT INTO DD EXTENT 

GET THE CURSOR MOVE LENGTH WORD 

PUT INTO DD EXTENT 

GET THE ADDRESS OF THE NEXT ROUTINE 

GET THE WRITE MODIFIER/EXIT COMMAND 

GO TO THE COMMON RETURN ROUTINE 



CONTROL WORD FOR WRITE W/O CRLF 

ADDRESS OF LEFT MARGIN POSITION TABLE 

EVEN SUBCHANNEL POSITION ADDRESS 

ODD SUBCHANNEL POSITION ADDRESS 

ASCII "ESC &" 

COLUMN POSITION FOR LEFT SIDE LEFT MARGIN 

ASCII "ESC &" 

COLUMN POSITION FOR RIGHT SIDE LEFT MARGIN 

WRITE MODIFIER/EXIT COMMAND: 

DO REQUEST IN DEX02-4, END NEXT READ ON CR 

DO NOT MODIFY WRITE IN DEX02 



The common return routine is used by all of the device driver routines that 
initiate their own requests to the interface driver. The return routine 
expects the address of the next routine to be in the B Register and the 
modifier/exit command to already be in the A Register. The return routine 
saves the next address in the device driver EQT extent word 13 and picks up 
the time out value used for all setup requests. 

CRTN STB DEX13.I SAVE NEXT ROUTINE ADDRESS IN DD EXT WORD 13 
LDB TO GET TIME OUT FOR SETUP REQUESTS 
JMP DDSOO.I RETURN TO INTERFACE DRIVER 



Stepping from one routine to the next is made simple by always saving the 
next routine address in device driver EQT extent word 13. On any 
continuation entry the device driver only has to jump through the contents 
of extent word 13 indirect: 



4-21 



DDSOO NOP 

STB TEMP 

CLE 

ELA.RAR 



LDB TEMP 
SEZ.RSS 
JMP CSOO 



DEVICE DRIVER ENTRY POINT 
SAVE B TEMPORARILY 

SAVE A[15] FOR CONTINUATION TEST 

SET UP DD EXTENT ADDRESSES 

RESTORE B 

TEST FOR CONTINUATION 

IF E (WAS A[15]) IS SET, GO TO CONTINUATION 



CSOO LDA DEX13.I GET NEXT ROUTINE ADDRESS 
JMP A, I GO DO IT 



Perform The Original User Request 



Since the original user request is restored to the device driver EQT extent 
words 2-4 on each entry to the device driver, processing the original 
request is quite simple. Before returning to the interface driver, the 
device driver only puts the system defined time out value in the B Register 
and an exit command equals 5 in the A Register. In this device driver the 
next routine address is also saved in the device driver EQT extent word 13 
to keep the flow of requests going. 



DORQ DEF «+1 

LDB EQT14.I 
LDA SENCU 
STA DEX13.I 
LDA M0DX2 
JMP DDSOO, I 



ADDRESS OF ROUTINE 

GET THE SYSTEM TIME OUT WORD 

GET THE NEXT ROUTINE ADDRESS 

SAVE IT FOR RETURN 

GET THE MODIFIER/EXIT COMMAND 

RETURN DIRECTLY TO THE INTERFACE DRIVER 



M0DX2 OCT 000005 



EQT 14 EQU 1773B 



UNIVERSAL DON'T MODIFY ANYTHING/DO REQUEST 
IN THE DD EXT MODIFIER/EXIT COMMAND 



Since further requests to the interface driver are required after completion 
of the original user request, the device driver must save the transmission 
log from the user request. This is accomplished by storing the contents of 
the B Register in EQT word 8, which was the original user request length (in 
characters) . 



Read Cursor Position 



SENCU senses where the cursor was left at the end of the user request. An 
escape - lower case a - DC1 (binary write) is sent to the terminal, 
requesting the terminal to send back the cursor position. The card is 
pre-configured for the next read by setting the high order bits in M0DX1. 
This demonstrates the read modifier on a write request: 
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SENCU DEF »+1 ADDRESS OF THE ROUTINE 

STB EQT8.I SAVE TRANSMISSION LOG IN EQT 8 

LDA BNWT SET UP BINARY WRITE 

STA DEX02.I IN DEVICE DRIVER EQT EXT 

LDA SENCA GET ADDRESS OF CURSOR SENSE 

STA DEX03.I FOR DD EQT EXT 

LDA SENSL GET LENGTH FOR SENSE COMMAND 

STA DEX04.I PUT IT IN THE DD EQT EXT 

LDA MODX1 WRITE MODIFIER/EXIT COMMAND 

LDB RDCUS GET THE ADDRESS OF NEXT 

JMP CRTN RETURN TO INTERFACE DRIVER 



Final Completion Return to the Interface Driver 

Completion is signified on return to the interface driver by a zero in the 
A Register and the user request transmission log in the B Register. 



LDB EQT8.I RETRIEVE TRANSMISSION LOG 

CLA SET COMPLETION EXIT COMMAND 

JMP DDSOO.I RETURN TO INTERFACE DRIVER 



EQT8 EQU 1667B 
Device Driver Address Table 

The following device driver address table is required to include the device 
driver with the interface driver at generation time. 

ASMB.Q 

NAM $DVTB,8 DEVICE DRIVER ADDRESS TABLE 
ENT $DVTB 
EXT DDSOO 

* 

» DEVICE DRIVER ADDRESS TABLE 

$DVTB DEC 1 NUMBER OF ENTRIES IN TABLE 
DEF DDSOO+0 ADDRESS OF DEVICE DRIVER 2 
END 

The device driver is then selected via a control function 33B, 000002 
request to the interface on either the subchannel or 1 LU. 
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Sample Device Driver Listing 



The following sample device driver is given to illustrate the various 
procedures involved in interfacing to the 12792B Multiplexer Interface 
Driver (DVMOO) . It is intended as an example only and is not a supported 
functioning product. 



0001 

0002* 

0003* 

0004* 

0005* 

0006* 

0007* 

0008* 

0009* 

0010* 

0011 

0012 

0013 

0014* 

0015 

0016 

0017 

0018 

0019 

0020 

0021* 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

0032 

0033 

0034 

0035 

0036 

0037 

0038* 

0039* 

0040* 

0041 

0042 



ASMB.Q 

MULTIPLEXER DEVICE DRIVER FOR SPLIT SCREEN OPERATION OF 
A 264X TERMINAL. LEFT HALF OF SCREEN IS SUBCHANNEL 0, 
RIGHT HALF IS SUBCHANNEL 1. FUNCTION IS OTHERWISE DVMOO. 
THIS DEVICE DRIVER WILL SET THE MARGINS FOR LEFT OR RIGHT 
HALF OPERATION AND POSITION THE CURSOR TO IT'S LAST KNOWN 
POSITION IN THE APPROPRIATE HALF OF THE SCREEN ACCORDING 
TO THE SUBCHANNEL ADDRESSED ON EACH OPERATION. 



00000 



00000 
00001 

01663 
01664 
01667 
01773 

00000 
00001 
00002 
00003 
00004 
00005 
00006 

00007 
00010 
00011 
00012 

00013 
00014 

00015 
00016 
00017 



NAM DDSOO, 8 SPLIT SCREEN DEVICE DRIVER 
ENT DDSOO 
EXT .CFER 

EQU 
EQU 1 
EQU 1663B 
EQU 1664B 
EQU 1667B 



A 

B 

EQT4 

EQT5 

EQT8 

EQT14 EQU 1773B 



000001R 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 



DEXAD 
DEX01 
DEX02 

DEX03 

DEX04 

DEX05 
DEX06 

DEX07 
DEX08 
DEX09 
DEX10 
DEX11 
DEX12 

DEX13 
DEX14 
DEX15 



DEF DEX01 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 



SETUP ON EACH ENTRY 

00020 000000 DDSOO NOP 

00021 00031 3R STB TEMP 



PHYSICAL RECORD LENGTH 
EQT6 COPY 
EQT7 COPY 
EQT8 COPY 
CURRENT SUB CH 



ROW WORD 1 
WORD 2 
COL WORD 1 
2 



CURRENT SUB CH 

" WORD 
CURRENT SUB CH 1 ROW WORD 1 

" WORD 2 
CURRENT SUB CH 1 COL WORD 1 

» WORD 2 
NEXT ROUTINE ADDRESS 
CURRENT (LAST) SUBCHANNEL 
FIRST ACCESS FLAG = ASCII SO 



SAVE B TEMPORARILY 
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0043 


00022 


000040 


CLE 






0044 


00023 


001623 


ELA, 


,RAR 




0045 


00024 


00000OR 


LDB 


DEXAD 




0046 


00025 
00026 


105745 
000267R 


LDX 


DM15 




0047 


00027 000001 


DEXLP STA 


B.I 




0048 


00030 


002004 


INA 






0049 


00031 


006004 


INB 






0050 


00032 


105760 


ISX 






0051 


00033 


000027R 


JMP 


DEXLP 




0052* 












0053 


00034 


00031 3R 


LDB 


TEMP 




0054 


00035 


002041 


SEZ, 


,RSS 




0055 


00036 000254R 


JMP 


CSOO 




0056* 












0057» 


SPECIAL PROCESSING TO SETUP EQT 


0058* 












0059 


00037 0000 17R 


LDA 


DEX15, 


I 


0060 


00040 


000277R 


CPA 


ASO 




0061 


00041 


000250R 


JMP 


SUBCK 




0062* 












0063 


00042 


000277R 


LDA 


ASO 




0064 


00043 


0000 17R 


STA 


DEX15, 


I 


0065* 












0066 


00044 


00000 1X 


JSB 


.CFER 




0067 


00045 


100005R 


DEF 


DEX05, 


I 


0068 


00046 


000300R 


DEF 


SORC 




0069 


00047 


00000 1X 


JSB 


.CFER 




0070 


00050 


100011R 


DEF 


DEX09, 


I 


0071 


00051 


000304R 


DEF 


S1RC 




0072* 












0073 


00052 


001664 


LDA 


EQT5.I 




0074 


00053 


000276R 


AND 


TMASK 




0075 


00054 


001664 


STA 


EQT5.I 




0076* 












0077* 


GET THE SUBCH 


AND DECIDE 


I THE F 


'A 


0078* 


SUB 1 


SET RIGHT MARGIN FIRST) 




0079* 












0080 


00055 


000261R 


JSB 


GTSCH 




0081 


00056 00001 6R 


SVSCH STA 


DEX14, 


I 


0082 


00057 000010 


SLA 






0083 


00060 


0001 17R 


JMP 


RMPOS, 


I 


0084 


00061 


000062R 


JMP 


LMPOS, 


I 


0085* 












0086* 


POSITION FOR LEFT MARGIh 


I SET 




0087* 












0088 


00062 


000063R 


LMPOS DEF 


*+1 




0089 


00063 


00031 OR 


LDA 


BNWT 




0090 


00064 


000002R 


STA 


DEX02, 


I 


0091 


00065 


0000 16R 


LDB 


DEX14, 


I 


0092 


00066 


000330R 


LDA 


LMPA 




0093 


00067 004010 


SLB 






0094 


00070 


002004 


INA 







SAVE A[15] FOR CONTINUE TEST 
SAVE EXTENT ADDRESSES 



A = ADDRESS OF DD EQT EXT 1 
B = ADDRESS OF DEX01 
DO FOR DEX01-15, ADDRESSES 
OF DEVICE DD EXT WORDS 1-15 



RESTORE B 

TEST FOR CONTINUATION 

GO DO CONTINUATION 



GET FIRST ACCESS FLAG 

CONTAINS ASCII "SO" 

NOT FIRST ACCESS, CHECK SUBCH 

FIRST ACCESS, SET UP FLAG 
SET UP SUB CH ROW AND COL 
SET UP SUB CH 1 ROW AND COL 

SET UP DRIVER TYPE 



GO GET SUBCHANNEL 

AND SAVE 

ODD SUBCHANNEL? 

YES, DO RIGHT MARGIN FIRST 

NO, DO LEFT MARGIN FIRST 



ADDRESS OF ROUTINE 

SET UP BINARY WRITE 

TO POSITION THE CURSOR 

GET SUBCHANNEL 

GET LEFT MARGIN POINTER 

ODD SUBCH USE THE OTHER ONE 
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0095 


00071 000000 


LDA 


A, I 




0096 


00072 000003R 


STA 


DEX03, 


I 


0097 


00073 000272R 


LDA 


CMLNG 




0098 


00074 000004R 


STA 


DEX04, 


I 


0099 


00075 0001 00R 


LDB 


LMSET 




0100 


00076 00031 4R 


LDA 


M0DX1 




0101 


00077 000256R 


JMP 


CRTN 




0102« 










0103* 


SET THE LEFT MARGIN 








0104* 










0105 


00100 0001 01 R LMSET 


DEF 


*+1 




0106 


00101 000310R 


LDA 


BNWT 




0107 


00102 000002R 


STA 


DEX02, 


I 


0108 


00103 000332R 


LDA 


LMSTA 




0109 


00104 000003R 


STA 


DEX03, 


I 


0110 


00105 000271R 


LDA 


MSLNG 




0111 


00106 000004R 


STA 


DEX04, 


I 


0112 


00107 00001 6R 


LDA 


DEX14, 


I 


0113 


00110 000010 


SLA 






0114 


00111 0001 14R 


JMP 


*+3 




0115 


00112 000117R 


LDB 


RMPOS 




0116 


00113 002001 


RSS 






0117 


00114 000154R 


LDB 


CUPOS 




0118 


00115 000314R 


LDA 


MODX1 




0119 


00116 000256R 


JMP 


CRTN 




0120* 










0121* 


POSITION CURSOR FOR 


RIGHT MARG 


ill 


0122* 










0123 


00117 0001 20R RMPOS 


DEF 


*+1 




0124 


00120 00031 OR 


LDA 


BNWT 




0125 


00121 000002R 


STA 


DEX02, 


I 


0126 


00122 00001 6R 


LDB 


DEX14, 


I 


0127 


00123 000345R 


LDA 


RMPA 




0128 


00124 004010 


SLB 






0129 


00125 002004 


INA 






0130 


00126 000000 


LDA 


A, I 




0131 


00127 000003R 


STA 


DEX03, 


I 


0132 


00130 000272R 


LDA 


CMLNG 




0133 


00131 000004R 


STA 


DEX04, 


I 


0134 


00132 0O0135R 


LDB 


RMSET 




0135 


00133 00031 4R 


LDA 


MODX1 




0136 


00134 000256R 


JMP 


CRTN 




0137* 










0138* 


SET THE RIGHT MARGIN 






0139* 










0140 


00135 0001 36R RMSET 


' DEF 


*+1 




0141 


00136 00031 OR 


LDA 


BNWT 




0142 


00137 000002R 


STA 


DEX02, 


,1 


0143 


00140 000347R 


LDA 


RMSTA 




0144 


00141 000003R 


STA 


DEX03, 


,1 


0145 


00142 000271R 


LDA 


MSLNG 




0146 


00143 000004R 


STA 


DEX04, 


,1 


0147 


00144 0000 16R 


LDA 


DEX14, 


,1 



GET THE ADDRESS 
PUT IT IN THE DD EXTENT 
GET CURSOR MOVE LENGTH WORD 
PUT IT IN THE DD EXTENT 
GET L. MARGIN SET ADDRESS 
WRITE MODIFIER/EXIT COMMAND 
RETURN TO INTERFACE DRIVER 



ADDRESS OF ROUTINE 

SET UP BINARY WRITE 

IN DEVICE DRIVER EQT EXT 

GET ADDRESS OF L. MARGIN SET 

FOR DD EQT EXT 

GET LENGTH FOR MARGIN SET 

PUT IT IN THE DD EQT EXT 

GET SUBCHANNEL 

ODD? 

YES, GO POSITION CURSOR 

NO, GET RIGHT MARGIN ADDRESS 

GET CURSOR POSITION ADDRESS 
WRITE MODIFIER/EXIT COMMAND 
RETURN TO INTERFACE DRIVER 

SET 

ADDRESS OF ROUTINE 

SET UP BINARY WRITE 

TO POSITION THE CURSOR 

GET SUBCHANNEL 

GET R. MARGIN ADDRESS POINTER 

ODD SUBCH USE THE OTHER ONE 

GET THE ADDRESS 
PUT IT IN THE DD EXTENT 
GET CURSOR MOVE LENGTH WORD 
PUT IT IN THE DD EXTENT 
GET R. MARGIN SET ADDR 
GET WRITE MODIFIER/EXIT 
RETURN TO INTERFACE DRIVER 



ADDRESS OF ROUTINE 

SET UP BINARY WRITE 

IN DEVICE DRIVER EQT EXT 

GET ADDRESS OF R. MARGIN SET 

FOR DD EQT EXT 

GET LENGTH FOR MARGIN SET 

PUT IT IN THE DD EQT EXT 

GET THE SUBCHANNEL 
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0148 
0149 
0150 

0151 
0152 

0153 
0154 
0155* 
0156* 

0157* 

0158 

0159 

0160 

0161 

0162 

0163 

0164 

0165 

0166 

0167 



0168 

0169 

0170 

0171 

0172 

0173 

0174 

0175* 

0176* 

0177* 

0178 

0179 

0180 

0181 

0182 

0183 
0184« 

0185* 

0186* 

0187 

0188 

0189 

0190 

0191 

0192 

0193 

0194 

0195 

0196 

0197 

0198* 



00145 
00146 
00147 
00150 
00151 
00152 
00153 



000010 

000151R 

000154R 

002001 

000062R 

00031 4R 

000256R 



SLA 
JMP 
LDB 
RSS 
LDB 
LDA 
JMP 



*+3 
CUPOS 

LMPOS 
MODX1 
CRTN 



ODD? 

YES, GO SET LEFT MARGIN 

NO, GET CURSOR POS. ADDRESS 

GET L. MARGIN POS. ADDRESS 
WRITE MODIFIER/EXIT COMMAND 
RETURN TO INTERFACE DRIVER 



POSITION CURSOR FOR OPERATION ON A SUBCHANNEL 



00154 000155R CUPOS DEF *+1 

00155 00031 OR LDA BNWT 

00156 000002R STA DEX02.I 

00157 00001 6R LDB DEX14.I 

00160 000360R LDA CPAD 

00161 004010 SLB 

00162 002004 INA 

00163 000000 LDA A, I 

00164 000361R LDB CPVAD 

00165 105777 MVW D4 

00166 000272R 

00167 000000 

00170 000362R LDA CPBFA 

00171 000003R STA DEX03.I 

00172 000273R LDA CPLNG 

00173 000004R STA DEX04.I 

00174 000177R LDB DORQ 

00175 00031 4R LDA M0DX1 

00176 000256R JMP CRTN 

DO THE ORIGINAL USER REQUEST 



00177 000200R DORQ 

00200 001773 

00201 000205R 

00202 0000 15R 

00203 0003 15R 

00204 000020R 



DEF *+1 
LDB EQT14.I 
LDA SENCU 
STA DEX13.I 
LDA M0DX2 
JMP DDSOO.I 



ADDRESS OF ROUTINE 

SET UP BINARY WRITE 

TO POSITION THE CURSOR 

GET SUBCHANNEL 

GET CURSOR ADDRESS POINTER 

ODD SUBCH USE THE OTHER ONE 

GET THE ADDRESS OF LAST 
AND THE BUFFER FILL ADDRESS 
MOVE THE LAST POSITION 



GET THE WHOLE BUFFER ADDRESS 
PUT IT IN THE DD EXTENT 
GET CURSOR MOVE LENGTH WORD 
PUT IT IN THE DD EXTENT 
GET DORQ ROUTINE ADDRESS 
WRITE MODIFIER/EXIT COMMAND 
RETRURN TO INTERFACE DRIVER 



ADDRESS OF THE ROUTINE 

GET THE TIME OUTWORD 

GET THE SENCU ROUTINE ADDRESS 

SAVE IT FOR RETURN 

GET THE EXIT COMMAND 

RETURN DIRECTLY 



USER REQUEST DONE, SENSE WHERE THE CURSOR WAS LEFT 



00205 000206R SENCU DEF *+1 

00206 001667 STB EQT8.I 

00207 00031 OR LDA BNWT 

00210 000002R STA DEX02.I 

00211 000363R LDA SENCA 

00212 000003R STA DEX03.I 

00213 000270R LDA SENSL 

00214 000004R STA DEX04.I 

00215 00031 4R LDA MODX1 

00216 000220R LDB RDCUS 

00217 000256R JMP CRTN 



ADDRESS OF THE ROUTINE 

SAVE TRANSMISSION LOG IN EQT8 

SET UP BINARY WRITE 

IN DEVICE DRIVER EQT EXT 

GET ADDRESS OF CURSOR SENSE 

FOR DD EQT EXT 

GET LENGTH FOR SENSE COMMAND 

PUT IT IN THE DD EQT EXT 

WRITE MODIFIER/EXIT COMMAND 

GET THE ADDRESS OF NEXT 

RETURN TO INTERFACE DRIVER 
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0199* 

0200» 

0201 

0202 

0203 

0204 

0205 

0206 

0207 

0208 

0209 
0210 
0211* 
0212* 

0213* 
0214 

0215 
0216 
0217 
0218 
0219 
0220 
0221 
0222 



0223 

0224 

0225 

0226* 

0227* 

0228* 

0229 

0230 

0231 

0232 

0233* 

0234* 

0235* 

0236 

0237 

0238* 

0239* 

0240* 

0241* 

0242 

0243 

0244 

0245* 

0246* 

0247* 

0248 

0249 



READ THE SENSED CURSOR POSITION 

00220 000221R RDCUS DEF *+1 

00221 00031 1R LDA REWCR 

00222 000002R STA DEX02.I 

00223 000366R LDA CRDBA 

00224 000003R STA DEX03.I 

00225 000273R LDA CPLNG 

00226 000004R STA DEX04.I 

00227 000232R LDB COMPL 

00230 0003 15R LDA M0DX2 

00231 000256R JMP CRTN 



ADDRESS OF ROUTINE 
CONTROL WORD FOR READ W/CR 
PASS TO I/F DRIVER 
ADDRESS OF BUFFER 

LENGTH 

ADDRESS OF NEXT ROUTINE 
GET THE EXIT COMMAND 
RETURN TO INTERFACE DRIVER 



COMPLETION ROUTINE, SAVES RETURNED CURSOR POSITION AND EXITS 



00232 000233R COMPL 

00233 0000 16R 

00234 000360R 

00235 000010 

00236 006004 

00237 000001 

00240 005200 

00241 000375R 

00242 105765 

00243 000274R 

00244 000000 

00245 001667 

00246 002400 

00247 000020R 



DEF *+1 

LDA DEX14,I 

LDB CPAD 

SLA 

INB 

LDB B,I 

RBL 

LDA CUBYT 

MBT D8 



LDB EQT8.I 

CLA 

JMP DDSCO.I 



ROUTINE ADDRESS 

GET CURRENT SUBCHANNEL 

GET CURSOR STORAGE POINTER 

ODD SUBCHANNEL. . . 

YES, USE THE OTHER ONE 

GET THE ADDRESS 

MAKE IT A BYTE ADDRESS 

GET BYTE ADDRESS 

MOVE BYTES 



RETRIEVE THE TRANSMISSION LOG 
SET EXIT COMPLETION COMMAND 



TEST FOR SUBCHANNEL ALREADY EQUAL, SKIP MOST OF SETUP 



00250 000261 R SUBCK JSB GTSCH 



00251 00001 6R 

00252 000177R 

00253 000056R 



CPA DEX14.I 
JMP DORQ.I 
JMP SVSCH 



GET REQUEST SUBCHANNEL 
COMPARE TO LAST ONE ADDRESSED 
SAME, GO DO USER REQUEST 
DIFFERENT, GO SET UP TERMINAL 



CONTINUATION PROCESS SELECTION 



00254 0000 15R CSOO LDA DEX13.I GET ADDRESS OF NEXT ROUTINE 

00255 000000 JMP A, I GO DO IT 

RETURN TO INTERFACE DRIVER ROUTINE A=MODIFIER/EXIT CMD, 
B=NEXT ROUTINE ADDRESS 

00256 0000 15R CRTN STB DEX13.I SAVE NEXT ROUTINE ADDRESS 

00257 00031 2R LDB TO GET THE SETUP TIME OUT 
00260 000020R JMP DDSOO.I 

SUBROUTINE TO RETURN THE SUBCH IN THE A REGISTER 



00261 000000 GTSCH NOP 

00262 001663 LDA EQT^.I 



GET SUBCHANNEL WORD 



4-28 



0250 


00263 000275R 




AND B3.7K 


ONLY LOOK AT SUBCHANNEL BITS 


0251 


00264 001727 




ALF.ALF 




0252 


00265 001222 




RAL.RAL 


POSITION TO RIGHT 


0253 


00266 000261R 




JMP GTSCH.I 




0254* 










0255* 


CONSTANTS AND 


VARIABLES 




0256* 










0257 


00267 177761 


DM15 


DEC -15 




0258 


00270 177775 


DM3 


DEC -3 




0259 


00271 000001 


D1 


DEC 1 




0260 


00272 000004 


D4 


DEC 4 




0261 


00273 000006 


D6 


DEC 6 




0262 


00274 000010 


D8 


DEC 8 




0263 


00275 003700 


B3.7K 


OCT 3700 




0264 


00276 014037 


TMASK 


OCT 14037 




0265 


00277 051460 


ASO 


ASC 1.S0 




0266 


00300 030060 


SORC 


ASC 4,000r000C 




00301 030162 










00302 030060 










00303 030103 








0267 


00304 030060 


S1RC 


ASC 4,000r042C 




00305 030162 










00306 030064 










00307 031103 








0268 


00310 000102 


BNWT 


OCT 000102 


CNWD FOR BINARY WRITE 


0269 


00311 000001 


RDWCR 


OCT 000001 


CNWD FOR READ TO CR, NO ECHO 


0270 


00312 177160 


TO 


DEC -400 


4 SEC TIME OUT ON SETUP 


0271 


00313 000000 


TEMP 


BSS 1 




0272 


00314 102005 


M0DX1 


OCT 102005 


WRITE MODIFIER/EXIT COMMAND 


0273* 








DO REQ. IN DEX02, END READS 


0274* 








ON CR, DON'T MODIFY WRITE. 


0275 


00315 000005 


M0DX2 


OCT 000005 


UNIV. MODIFIER/EXIT COMMAND 


0276* 








DON'T MODIFY ANYTHING, 


0277* 








JUST START REQUEST IN EXTENT 


0278* 










0279* 


TERMINAL COMMAND STRINGS 




0280* 










0281 


00273 


CPLNG EQU D6 


LENGTH OF CURSOR POSITION RQ 


0282 


00272 


CMLNG EQU D4 


LENGTH OF MARGIN REQUESTS 


0283 


00271 


MSLNG EQU D1 


LENGTH OF MARGIN SET REQUESTS 


0284* 










0285 


00316 015446 


LMPAO 


OCT 15446 


(ESC&) POS. CURSOR FOR LEFT 


0286 


00317 060440 

00320 030060 

00321 030103 




ASC 3, a OOOC 


MARGIN SET, SUB 


0287 


00322 015446 


LMPA1 


OCT 15446 


(ESC&) POS. CURSOR FOR LEFT 


0288 


00323 060440 

00324 030064 

00325 031103 




ASC 3, a 042C 


MARGIN SET, SUB 1 


0289 


00326 0003 16R 


LMPAD 


DEF LMPAO 


ADDRESS OF LEFT MARGIN, SUB 


0290 


00327 000322R 




DEF LMPA1 


ADDRESS OF LEFT MARGIN, SUB 1 


0291 


00330 000326R 


LMPA 


DEF LMPAD 


ADDRESS OF ADDRESSES 


0292* 
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0293 

0294 

0295* 

0296 

0297 



0298 
0299 



00331 015464 LMST OCT 15464 

00332 000331R LMSTA DEF LMST 



RMPAO OCT 15446 

ASC 3, a 037C 



00333 015446 

00334 060440 

00335 030063 

00336 033503 

00337 015446 

00340 060440 

00341 030067 

00342 034503 

00343 000333R RMPAD DEF RMPAO 

DEF RMPA1 

RMPA DEF RMPAD 



RMPA1 OCT 15446 

ASC 3, a 079C 



00344 000337R 

00345 000343R 



00346 015465 RMST OCT 15465 

00347 000346R RMSTA DEF RMST 



00350 015446 

00351 060440 

00352 000000 



CPBUF OCT 15446 



ASC 
CPVAL BSS 



1,a 

4 



00356 000005R CPADD DEF DEXC5 



00357 00001 1R 
00360 100356R CPAD 



DEF DEX09 
DEF CPADD, I 



0300 
0301 
0302 

0303* 
0304 

0305 

0306» 

0307 

0308 

0309 

0310 

0311 
0312 

0313 
0314 
0315* 
0316 

0317 

0318 

0319 

0320* 

0321* RETURN AREA FOR CURSOR SENSE 

0322* 

00366 000367R CRDBA DEF CRDBF 

00367 000000 

00370 000000 

00371 000000 

00372 000000 

00373 000000 

00374 000000 



00361 000352R CPVAD DEF CPVAL 

00362 000350R CPBFA DEF CPBUF 

00363 000364R SENCA DEF SENCC 

00364 015541 SENCC OCT 15541 

OCT 10400 



00365 010400 
00270 



SENSL EQU DM3 



0323 
0324 
0325 
0326 
0327 
0328 
0329 
0330 

0331 



CRDBF NOP 
NOP 
NOP 
NOP 
NOP 
NOP 

00375 00076 1R CUBYT DBR CRDBF+1 

END 



SET L. MARGIN COMMAND (ESC4) 
AND ADDRESS 

(ESC&) POSITION CURSOR FOR R. 
MARGIN SET, SUB 



(ESC4) POSITION CURSOR FOR R. 
MARGIN SET, SUB 1 



ADDRESS OF R. MARGIN, SUB 
ADDRESS OF R. MARGIN, SUB 1 
ADDRESS OF ADDRESSES 

SET R. MARGIN COMMAND (ESC5) 
AND ADDRESS 

(ESC&) POSITION CURSOR FOR A 
SUB CHANNEL FOR OPERATION 
AREA TO PUT CURSOR COORD. 
ADDR OF CURSOR COORD. SUB 
ADDR OF CURSOR COORD. SUB 1 
ADDRESS OF ADDRESSES 
ADDRESS OF COORDINATE STORAGE 
ADDRESS OF BUFFER 

ADDR OF SENSE CURSOR COMMAND 
(ESCa) SENSE CURSOR COMMAND 
DC1 SEND DATA 
CHAR COUNT FOR SENSE COMMAND 



CURSOR READ BUFFER ADDRESS 

SPACE FOR ESC & 

SPACE FOR aY 

SPACE FOR YY 

SPACE FOR rX 

SPACE FOR XX 

SPACE FOR C 

BYTE ADDRESS OF RIGHT BYTE 



** NO ERRORS "TOTAL **RTE ASMB 92067-16011** 
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Chapter 5 

Device-Specific Considerations 



The Multiplexer subsystem supports the following HP terminals as well as 
printer support for the 263X and the 7310A: 

2621A/B/P 26itOA/B 2622A 2628A 

26U5A 261+7A 2623A 2635B 

26U8A 261+9B/C/G 262UB 2382A 

2626A 2625A l*56lOA 

2627A 

Other HP or non-HP devices may be used in conjunction with the 12792B 
multiplexer subsystem. A prerequisite for HP support is the device must be 
either point-to-point hardwired (or modem linked using the HP 3721UA systems 
modem subsystem), in an asynchronous, bit-serial environment. However, for 
these devices it may be necessary for the user to write simple device 
drivers to supplement line protocol and specific control characters. 



Handshaking 



Transmission and reception of data or instructions are coordinated by 
firmware controlled handshaking. Handshaking can be approached from one of 
two aspects; either from the multiplexer firmware or from the device acting 
as the transmitter. Some line printers and other devices use hardware 
handshaking between the computer and the terminal/device; these devices are 
not supported. 

The HP 12792B interface card uses firmware on the interface card rather than 
a software driver to accomplish ENQ/ACK handshaking and other line protocol | 
necessary to communicate between the MUX card and a terminal/device. If the 
card configuration has ENQ/ACK handshaking enabled, data is transferred to 
the terminal/device in the following manner: 

The card sends data to the terminal/device in blocks of 80 characters. 
Between blocks an ENQ is sent and the firmware waits up to five 
seconds for an ACK. If one block is acknowledged the next block is | 
sent. If no response is given, another ENQ is sent. 

If the handshaking is disabled, information is transmitted serially 
(character by character) to the terminal/device. 

The other type of handshaking is from the terminal/device to the Multiplexer 
card and this is accomplished using DC1 and DC2 handshaking. DC1 and DC2 
are used for CPU reception in block mode. This type of handshaking is 
controlled by the terminal driver DDV05. 
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The XON/XOFF handshake for pacing the data sent to a terminal is also 
supported on the multiplexer. Control function 34B is used to enable and 
disable XON/XOFF handshaking (refer to Chapter 2 under function 34B for 
details) . 

The device control signals XON and XOFF that allow the user to control or 
pace transmission from the terminal are treated by the multiplexer as 
handshake characters. XON starts transmission when Control-Q is received by 
the multiplexer and transmission stops when Control-S is received. Use of 
XON and XOFF are enabled in the Port Configuration control request (refer to 
function 34B in Chapter 2). 



DDV12 Lineprinter Driver 



HP supplies a line printer driver (DDV12) similiar to DVR12, although some 
limitations are: 



- no vertical form feed except top of form 

- no over print carriage control ( * in col 1 ) 

- no status requests 



DDV05 Terminal Driver 



When using the HP 264X terminal in the Multiplexer subsystem, the device 
expects to see 8-bits per character data transfers. Users wanting to 
communicate with a 264X or 262X terminal with parity checking should 
configure the interface card for a 7-bits per character data transfer, or 
without parity use 8-bits per character. The 264X terminals require 
handshaking with the ENQ/ACK protocol in order to preserve data integrity. 
These terminals use a block mode handshaking scheme with the CPU receiving 
DC1/DC2 protocol. A DC1 must be detected before the information can be sent 
across the line. 
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Black Box Considerations 

In order to connect a "black box" RS-232-C or RS-U23-A device to the HP 
12792B Multiplexer Interface, the following three criteria must be examined: 

RS-232-C and RS-U23-A Capability 

Handshaking 

Driver Considerations 



HP offers support to most RS-232-C and RS-1+23-A compatible devices. HP 
support is limited to correct passage of user's data to and from the user's 
buffer and from and to the specified multiplexer channel data links with 
insertion and deletion of specifying characters and parity information. 

The user should be aware of the line protocol, control sequences, and 
handshaking used by the device. The line protocol must match in order for 
two way communication to exist. The user must understand how requests are 
mapped in as control requests. The user must specify whether the 
terminal/device uses character or block mode handshaking. 

The last consideration requires the user to determine if the terminal/device 
can function using the HP supplied drivers, or if it will require a user 
written device driver. Any specialized control which is required by the 
device not included in the user buffer indicates the need for a user written 
device driver. When functioning with user written device drivers, support 
is also limited to correct passage of EQT extent information to and from the 
user's device driver and the correct execution of the device drivers 
requests . 

NOTE: The use of short records can cause the CPU to become 10 bound. 



Dumb Devices 

If the device requires no additional information beyond what is contained in 
the user's buffer and does not use DC1 handshaking, the device can be 
considered a "dumb" device and will be able to operate using DVMOO and the 
default device driver (device driver number one). Some devices that are 
normally considered dumb devices actually require CR/LF delays and will 
require a user written device driver for proper operation. One example of 
these devices is the common Teletype. 
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Modems 

The HP 12792B Multiplexer has no modem control lines but it may be connected 
to an HP 3721^+A systems modem subsystem, and modem control and I/O cards for 
full-duplex asynchronous modem operation. The active control functions of 
the modem are contained in the modem panel and the multiplexer and its 
driver need only to take care of the passive functions. For example when 
using modems, if the modem line is disconnected, the condition is detected 
by the modem panel, not the multiplexer. 

Be aware that if a user logs on under an RTE session and the line is 
disconnected before the user logs off, anyone dialing into that port will be 
re-connected to the session in progress at the time of the previous 
disconnect unless a program such as MODEM is used with the 3721UA System 
Modem Subsystem. 

Cartridge Tape Units 

DDV05 can access subchannels (display/keyboard), 1 (left CTU) and 2 (right 
CTU) . The CTU's can be used with FMGR stores and dumps, etc., the same as 
DVA05. Applications programs can directly control access as follows: 

READ /WRITE Request. This driver uses only bit 6 of the control word to 
determine whether this is an ASCII or BINARY READ/WRITE request. 

ASCII READ is a string of characters terminated by a CR. A record will be 
read from the CTU to the user buffer. Any data exceeding the user buffer 
length will be lost. 

NOTE: In the sequence below, the CPU is sending to a device, and receiving 
from a device. 

SEND: ESC c ESC & p DEV s R DC1 
REC: DATA CR 
SEND: ESC b 

BINARY READ is a string of characters specified by the buffer length or by 
the byte count from the CTU, whichever is smaller. A record will be read 
from the CTU. 

SEND: ESC c ESC & p DEV s 2 R DC1 

REC: BYTECOUNT CR 

SEND: DC1 

REC : DATA 

SEND: ESC b 

ASCII WRITE a string of characters to the CTU terminated by a CR. 

SEND: ESC c ESC & p DEV d W DATA CR LF DC1 
REC: S CR (for successful completion) 
SEND: ESC b 
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BINARY WRITE a string of characters specified by the buffer length. Maximum 
record length is 256 bytes. 



SEND: 


ESC c ESC t p DEV d BYTECOUNT W ENQ 


REC: 


ACK 


SEND: 


DATA DC1 


REC: 


S CR 


SEND: 


ESC b 



An RS will be sent by the CTU during a write operation if an EOF is 
encountered. 



Control Request 



Function Description 

00 Unlock Keyboard 

01 Write End-of-File Mark 

02 Back Space 1 Record 

03 Forward Space 1 Record 
Ok Rewind 

05 Rewind Standby 

06 Dynamic Status (will read & return CTU status) 
13 Forward Space 1 File 

lU Back Space 1 File 

26 Write End-of-Data (EOD) 

27 Locate file, the absolute file number is in the 
optional parameter. 

Any error will be returned in the EQT5 status byte. 

Device Control Sequence 

SEND: ESC c ESC & p DEV u 

[[+ OR -] COUNT p] CMD C DC1 
REC: S CR 
SEND: ESC b 

Device Status Sequence 

SEND: ESC & p DEV " DC1 
REC: ESC \ p DEV STATUS CR 

DEV = 1 for left CTU, 2 for right CTU 

ESC c = Lock keyboard 

ESC b = Unlock keyboard 

CMD = Control request command to CTU 
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Appendix A 

Device Equipment Table 



The HP 12792B Multiplexer Subsystem requires a Device Equipment Table (EQT) 
entry for each port on the multiplexer. The entry consists of 15 words plus 
an extension of 31 words, or a total of 1+6 words. The EQT entry is 
configured into the RTE Operating System at system generation time. 

During system operation, the device and interface drivers receive channel 
configuration instructions, and passes information to each other through the 
EQT entry for that channel. Table A-l provides the function at each word in 
the Equipment Table Entry in RTE-IVB and RTE-6/VM operating systems. 



Table A-l. Equipment Table Entry. 



EQT Words 1-8: 


standard in the RTE operating environment. 


Word 5* 


the status word, bits 7~0 describe the channel's 
status unless it is altered by a device driver: 






Bit 7 


Reserved for future use, should be set to 


zero 




Bit 6 


BREAK key hit 






Bit 5 


EOT (control-D entered) 






Bit k 


Modem line down. 






Bit 3 


Parity error or overflow 






Bit 2 


Type-ahead data available 






Bit 1 


Program scheduling enabled 






Bit 


Last request timed out 




Word 9: 


On initiation entry this is an optional user 
parameter to the device driver. Thereafter, 
it is the starting address for transfers. 
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Word 


10: 


On initiation entry, this is an optional user 






parameter 


to the device driver. Thereafter, 






it i 


s the 


character length of the data transfer. 


Word 


11: 


Port 


Status Word 1 






Bit 


15: 


Card is busy processing a command 






Bit 


14: 


Deferred abort in process 
(system clear request) 






Bit 


13: 


Waiting for or using DCPC channel 






Bit 


12: 


Reserved for future use 






Bit 


11: 


Using DCPC channel 1 (select code = 6) 






Bit 


10: 


I/O transfer in process 






Bit 


9: 


Unsolicited interrupt in progress 






Bit 


8: 


Defer abort flag 






Bit 


7: 


End on CR 






Bit 


6: 


End on RS 






Bit 


5: 


End on CNTL D 






Bit 


4: 


End on DC2 






Bit 


3: 


End on Count 






Bit 


2: 


End on Character 






Bit 


1: 


Edit enable 






Bit 


0: 


Echo enable 


Word 


12: 












Bit 


15: 


This EQT is suspended on itself 






Bits 


, 14-0 


: The address of first EQT suspended, 
waiting for access to the backplane. 


Word 


13: 


Address o 


f EQT extension 


Word 


14: 


Standard 


usage: EQT time-out value reset 


Word 


15: 


Standard 


usage: EQT running timer 
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EQT extension words: (extension word 1 = EQT word 16) 



Word 16: 



Address of the program to schedule 
-1 if none 
if the driver has not been entered 



Word 17: Level 1 subroutine return address 



Word 18: Level 2 subroutine return address 



Word 19: Level 3 subroutine return address 



Word 20: 



Port ID from control 3 OB optional parameter, 
used in power fail recovery 



Word 21: Driver configuration word (from control 33B) 



Word 22: Reserved for future use 



Word 23: Length of typed-ahead data, in characters 



Word 24: 



Temporary, usually contains the character 
length of the data remaining to be transferred 



Word 25: 



Temporary, usually the second word of the card 
command 
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Word 26: 


Temporary, usually the length of the character 
space left in the user buffer 


Word 27: 


Port Status Word 2: 

Bit 15: Terminating character has not yet been 

found 
Bit ll4,13: 00 = control-D (terminating character) 

01 = <CR> 

10 = <DC2> 

11 = <RS> 

Bit 12: Reserved for future use 

Bit 11: Card reset in progress 

Bits 10-9: Reserved for future use 

Bit 8: Port has key 

Bits 7-0 : default status for word 5 bits 7-0 


Word 28: 


Device driver command to the interface driver 
(A-Register) 


Word 29: 


Type ahead schedule retry counter 


Word 30: 


Running counter for TA schedule retries 


Word 31: 


CN 31 parm 


Word 32: 


CN 32 parm 


Word 33: 


Modem alarm prog ID segment address 


Word 3k: 


Card and error code for MODEM 


Word 35: 


Card status for MODEM 


Word 36: 


EQT address of this LU for MODEM 


Word 37: 


Loglu for MODEM 


Word 38: 


Parm 5 for MODEM (must always be 0) 


Word 39: 


Device driver timeout, -10' s ms 


Word U0: 


Device driver EXEC request 


Word 1*1: 


Device driver I/O buffer address or control 
requests optional parameter 


Word U2: 


Device driver buffer length (+words, -chars) 



Any further storage used is defined by the device driver in use. 
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Appendix B 
Device Driver Interfaces 



HP 26XX Screen Mode Device Driver 

This section describes the HP supplied 26XX Screen Mode device driver DDV05 
used with the Multiplexer interface driver DVMOO. The driver supports HP 
terminals in both character and block mode. All screen mode functions (the 
ENTER key, soft keys, etc) are supported. Peripheral devices (CTUs, etc.) 
are NOT supported by this device driver. 

The layout of the user I/O and Control calls are designed to be roughly 
compatible with DVR05. Since this subsystem is be able to support a far 
wider range of terminal capabilities, differences are inevitable. 

For generation and initialization information please refer to the 
configuration guide. 



DDV05 User Interface For HP 26XX Terminals 



The device driver DDV05 utilizes the block mode read capabilities of an 
HP264X or 262X terminal. At boot-up time the device driver reads the 
terminal straps. The strappings may vary between character, block line, or 
block page mode. The character mode is a normal read operation, with a 
carriage return or CNTL-D indicating an end-of-record . A carriage return 
denotes an end-of-record in the block line mode, while a record separator 
denotes an end-of-record in the block page mode. Prior to every read 
request, the device driver instructs the interface driver to write a DC1 
allowing the softkeys to be read. 
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Subchannel Assignment 

No support for peripheral devices is given, therefore EQT subchannels are 
ignored. However, for compatibility with existing and future products, the 
subchannel field should be set to zero. 

Control Request Definition 

The control requests accepted by this driver perform various functions. 
Some requests require additional data which is passed to the driver through 
the optional EXEC parameter IPARM. Any control request not listed here is 
passed on to the interface driver for execution. The various requests are 
described as follows: 



Control Function 11B, Line Spacing 

Control function 1 1B sends a number of CR/LF's to the terminal's 

display as determined by the value of the optional parameter. A maximum of 
63 lines can be spaced in one request. Any value greater than 63 will be 
truncated modulo 64. A zero or negative line count results in one CR/LF 
sent. 

Control Function 25B, Update Terminal Configuration 

Control function 25B causes the driver to read the strap settings on HP 
terminals. This information is used by the driver to assure correct 
terminal handshake when doing block reads, etc. on HP terminals. 

A control function 25B is automatically performed when the driver receives 
its first read request. If the terminal straps are subsequently changed 
manually or by escape sequences the user must issue another control function 
25B to keep the driver posted of any changes. Failure to do so may result 
in the terminal getting "hung up". 

Input/Output Requests 

The action taken by the driver in the processing of I/O requests depends on 
the function code specified in the EXEC call from the user. Bits 10 through 
6 of the EXEC ICNWD define the function code for the request as follows: 
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10 9 8 7 6 


Action taken for READ request 




0X0X0 


input editing enabled, echo off, end transfer 
on <CR> or CTRL-D 




0X1X0 


input editing enabled, echo on 
end transfer on <CR>, or CTRL-D 




0X0X1 


input editing off, echo off, end transfer 
on buffer full 




0X1X1 


editing off, echo on, end 
transfer on buffer full 




1X0X0 


editing off, echo off, end transfer on <CR> 




1X1X0 


editing off, echo on, end 
transfer on <CR> 





10 9 8 7 6 Action taken for WRITE request 



X X X end transfer on end of buffer, add CR/LF if 

last char in buffer is NOT "_". "_" is not printed if 

present as the last char in buffer 

X X X 1 end transfer on end of buffer, nothing is added to 
the user's buffer 

1 X X X end transfer on end of buffer, nothing is added to 

the user's buffer 



For all I/O requests note the following: 

Zero length keyboard entries will not be ignored by the interface driver. 

I/O transfers use a character format set up by control fuction 3 0B, and 
the terminal must be strapped accordingly. 

Escape and Unit Separator characters are NOT stripped from the user's 
buffer as is done under DVR05. 

Binary type transfers from the display may not be used when the terminal 
is in a block mode. 
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Read function code 3000B "program enabled block read" is not required 
when doing ESC-d screen reads. However, the driver is not as "forgiving" 
as DVR05 when terminal straps are changed without informing the driver. 
Control function 25B must be issued in order to prevent the terminal from 
being "hung up". 



HP 7310 Line Printer Device Driver 

Functional Overview 

This section describes the HP 2631/2635/7310 Line Printer device driver 
DDV12 for use under the Multiplexer driver DVM00. The driver supports both 
normal (column 1 as carriage control) and transparent (column 1 printed) 
print modes. Carriage control includes Top-of-Form, single, double, and 
triple spacing. 

For Generation and Initialization information consult the HP 12792B 
Multiplexer Subsystem Configuration Guide. 

Write Request Processing 

Write requests to the driver can be made either in a normal or transparent 
mode. The device driver DDV12 is used to make HP 2631/2635/7310 printers 
look like typical line printers to user programs. These devices use escape 
sequences for carriage control while standard line printers interpret the 
first character of each line as a carriage control character. The DDV12 
device driver examines the user's first character and sends the proper 
escape sequence to the printer. In normal mode the first character of the 
line is used to direct the driver to perform carriage control. The 
remainder of the line is transferred to the printer. Carriage control 
characters recognized by the driver are: 

"1" Go to Top-of-Form 

"0" Space one extra line before printing (double space) 

"-" Space two extra lines (triple space) 

all others Single space 



CAUTION 



DW12 recognizes underscores as a line continuation special 
character. Text and programs using underscores for other purposes 
will print in an undesirable format. In such cases, a 
point-to-point connection should be used. 
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Transparent mode is selected by setting bit 7 of the EXEC function code. In 
this mode all data is shipped to the printer regardless of the data in 
column 1. 

It should be noted that no processing of the user data is performed other 

than that described above. Since the printer always reacts to escape 

sequences and protocol characters (e.g. ENQ) , the user should be careful 
not to place these in the user buffer. 

Control Request Processing 

The only control request processed by this device driver is control function 
1 1B . This is used to either move the paper up (line spacing) or move the 
paper to top-of-form, depending on the value of the optional parameter. 

IPARM > move the paper up IPARM lines 

IPARM = move the paper up one line 

IPARM < go to top-of-form 

The maximum number of lines that can be spaced in one request is 63. If a 
request is made to send more than 63 lines the value will be truncated 
modulo 64. (i.e 66 will send 2 lines.) 

All other control requests are passed directly to the interface driver for 
processing. Refer to Chapter 2 for descriptions. 
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Appendix C 
Glossary 



ACK - Acknowledge 



ASCII 



A transmission control character transmitted by a 
receiver as an affirmative response to the 
sender's block mode information. 

American Standard Code for Information 
Interchange. 



ASYNCHRONOUS TRANSMISSION Transmission in which time intervals between 

transmitted characters may be of unequal length. 
Transmission is controlled by start and stop 
elements at the beginning and end of each 
character. 



BAUD 



BS 



CONTROL CHARACTER 



CR 



DC1 - Device control 



DC2 - Device control 



A unit of signaling speed equal to the number of 
discrete conditions or signal events per second. 
In asynchronous transmission, the unit of 
signaling speed corresponding to one unit 



if the duration of 

milliseconds, the 

Baud is the same as 

each signal event 



interval per second; that is, 
the unit interval is 20 
signaling speed is 50 baud, 
"bits per second" only if 
represents exactly one bit. 

Backspace, Control H. 



In the ASCII code, any of the 32 characters in 
the first two columns of the standard code table. 

Carriage return, Control M. 

A device control character which is primarily 
intended for turning on or starting a peripheral 
device. The host is receiving information, 
Control Q. 

A device control character which is primarily 
intended for turning on or starting a peripheral 
device, Control R. 
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DIRECT MEMORY ACCESS (DMA) A facility that permits I/O transfers directly 

into or out of memory independent of the 
processor. 



DUMB DEVICE 



DUPLEX 



Device that processes one unit of information at 
a time. It does not contain its own local 
processing capability. In a smart device this is 
typically accomplished with a microprocessor. 

Simultaneous two-way independent transmission in 
both directions. Also referred to as 
full-duplex. 



ECHO 



A method of checking the accuracy of transmission 
of data in which the received data are returned 
to the sending end for comparison with the 
original data. 



ENQ - Enquiry 

EOT 
HALF-DUPLEX 



A transmission control character used as a 
request for a response, Control E. 

End-of-Transmission, Control D. 

A circuit designed for transmission in either 
direction but not both directions simultaneously. 



INPUT EDITING 



When enabled, the backspace and delete key are 
enabled and will affect the user's buffer. When 
disabled, the keys are not executed but are 
placed in the user's buffer. 



INTERFACE 



The multiplexer card making possible 
interoperation between the terminal/device and 
the CPU. 



MODEM 



A device that modulates and demodulates signals 
transmitted over communications circuits. 



PARITY CHECK 



Addition of non-information bits to data, making 
the number of ones in each grouping of bits 
either always odd for odd parity or always even 
for even parity. This permits single error 
detection in each group. 
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PROTOCOL A formal set of conventions governing the format 

and relative timing of message exchange between 
two communicating processes. 

TRANSMISSION LOG Length of buffer contents to or from the MUX 

card. 

VALID TERMINATOR End of data transfer, end of record, for example 

a carriage return. 
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Index 



$DVTB device driver address table, 4-13, 4-14 

$DVTB SAM, 4-14 

$DVTB sample code, 4-23 

$DVTB table area I, 4-14 



26XX screen mode device driver 
DDV05, 4-4, B-1 



7310 line printer device driver 
DDV12, 4-3, B-4 



A-register interface 
driver, 4-7 
driver returns, 4-6 



B 



B Register 

device driver, 4-10 

interface driver returns. 4-7 

return to interface driver, 4-10 
Baud rate 

generators, 2-22 

generators port specification, 2-22 

specification, 2-23 
Binary data reads 

device driver EQT extent, 4-7 
Black box 

compatibility, 5-3 

driver considerations, 5-3 

handshaking, 5-3 

HP support, 5-3 
Break key action, 2-27 
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Case study 

cursor position, 4-15 

cursor tracking, 4—1 6 

device driver writing example, 4-15 

margin set up, 4-15 

minor tasks, 4-16 

task definition, 4-15 
Channel transmission, 1-3 
Clear extraneous commands 

control 26B, 3-2 
Common type-ahead modes, 3-4 
Configure driver responses 

break key action, 2-27 

defining a device driver to this port, 2-28 

example, 2-28 

function code, 2-26 

general description, 2-26 

scheduling, 2-27 

sending read configuration into the card, 2-28 

specifying unique read request type, 2-28 

type-ahead action, 2-27 

type-ahead feature specification, 2-27 
Continuation entry 

device driver, 4-19 

system abort request, 4-5 

test, 4-19 
Control request 

configure driver responses, 2-26 

device initialization, 2-14 

disable schedule, 2-19 

dynamic status, 2-14 

enable scheduling, 2-18 

file manager format, 2-12 

flush input buffer, 2-21 

function codes, 2-13 

general format, 2-12 

required parameters, 2-13 

set port's ID, 2-22 

set program address, 2-21 

set read type, 2-30 

set timeout, 2-20 
Control request to the MUX, B-5 

full type-ahead, 3-5 

no type-ahead, 3-5 

write request, B-5 
Control word 

general, 2-1 

read request, 2-5 

write request, 2-6 
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Control Function 

1 1B line spacing, B-2 

25B update terminal configuration, B-2 
Cursor 

position, 4-15 

position case study, 4-15 

tracking, 4-16 

tracking case study, 4-16 



Data 

overrun error, 3-8 

overrun error read error, 3-8 

transfers packing, 4-2 

transfers parity, 4-2 
DC1/DC2, 5-2 

DC1/DC2 handshaking, 5-2 
DDV05 vs DVR05 comparison, B-1 
DDV05 

block line mode, B-1 

block mode terminal device driver, 4-4 

block page mode, B-1 

block read, 4-4 

character mode, 4-4, B-1 

control request definition, B-2 

data transfers, 5-2 

DC1, DC2, 4-4 

editing, 4-4 

handshaking requirements, 5-2 

I/O requests, B-2 

line spacing, B-2 

read requests, B-3 

special I/O considerations, B-3 

status checking, 4-4 

subchannel assignment, B-2 

terminal driver, 5-2 

update terminal configuration, B-2 

user interface for 26XX terminals, B-1 

write requests, B-3 

carriage control, 4-3, B-4 

changing device type, 4-3 

control request processing, B-5 

functional overview, B-4 

limitations, 5-2 
DDV12 

line printer driver, 5-2 

line spacing, B-5 

normal print mode, B-4 

paper advance, B-5 

transparent 

mode selection, B-5 

print mode, B-4 

write request processing, B-4 
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Device driver 

26XX screen mode device driver, B-1 

7310 line printer device driver, B-4 

A-register, 4-6 

adding device drivers, 4-13 

address table $DVTB, 4-13 

address table format, 4-14 

address table general description, 4-13 

address table valid device driver labels, 4-14 

B Register, 4-6 

base page locations, 4-6 

case study, 4-15 

changing device type, 4-3 

character mode, 4-4 

concept, 4-1 

continuation entry, 4-19 

correct status, 4-3 

customizing, 4-1 

DDV05, 4-4 

DDV12, 4-3 

device address table, 4-13 

device driver address table, 4-23 

device driver writing example, 4-15 

double buffering, 4-12 

dynamic switching, 4-1 

EOT, 4-3 

EOT extent binary data reads, 4-7 

EOT extent general description, 4-7 

EOT extent pointers set up, 4-19 

EOT word 1, 4-7 

EOT word 10, 4-6, 4-13 

EQT word 14, 4-6, 4-13 

EOT word 15, 4-13 

EQT word 2, 4-7 

EQT word 3, 4-7 

EQT word 4, 4-7 

EQT word 5, 4-11 

EQT word 7, 4-12 

EQT word 8, 4-13 

EQT word 9, 4-6, 4-13 

EQT words 2-4, 4-6, 4-7 

EQT words 4-10, 4-6 

EQT words 6-8, 4-6 

equipment type code, 4-1 1 

exit commands, 4-8 

final completion return to the interface driver, 4-23 

I/O considerations, 4-4 

interface, 4-4 

interface driver concept, 4-1 

interface general definition, 4-4 

location and size of device drivers, 4-14 

modify EQT, 4-10 

operation, 4-16 

operation flow, 4-18 

output a set up string to terminal, 4-20 

perform the original user request, 4-22 
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read cursor position, 4-22 

Read/Write control request considerations, 4-4 

request legality, 4-3 

request types. 4-12 

restrictions and requirements, 4-5 

return routine, 4-21 

sample listing, 4-24 

sequence of actions, 4-16 

set up device driver EQT extent pointer, 4-19 

set up on first entry, 4-19 

special sequences, 4-3 

status definitions, 4-11 

subchannel determination, 4-20 

system abort request, 4-5 

tasks, 4-3 

transmission log, 4-3 

unrecognized control request, 4-5 

use, 4-1 

user request, 4-3 

user written device driver considerations, 4-4 

valid labels, 4-14 

writing example, 4-15 
Device initialization 

configure driver responses, 2-14 

enable scheduling, 2-14, 2-18 

set port ID, 2-14 
Disable schedule 

example, 2-20 

general description, 2-19 
DMA, 4-3 

DMA interface driver, 4-3 
Dumb device, 5-3 
DVM00 

interface driver, 4-2 
Dynamic status 

character length of any T A data, 2-14 
general, 2-14 
port's status, 2-14 



Enable scheduling 

conditions, 2-18 

example, 2-19 

general description, 2-18 
EQT 

set up on first entry, 4-19 

word 10 device driver, 4-13 

word 10 length of secondary buffer, 4-13 

word 14 device driver, 4-13 

word 15 device driver, 4-13 

word 4 subchannel, 4-10 
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word 5 equipment type code and status, 4-1 1 
word 5 interface driver, 4-7 
word 5 status definitions, 4-1 1 
word 6 double buffering, 4-12 
word 6 request types, 4-12 
word 7, 4-12 

word 7 device driver, 4-12 
word 8, 4-13 

word 8 device driver, 4-13 
word 9 address of secondary buffer, 4-13 
word 9 device driver, 4-13 
EQT 

modify, 4-10 

set up on first entry, 4-19 
word 

word 1, 4-7 
word 10, 4-6, 4-13 
word 14, 4-6, 4-13 
word 15, 4-13 
word 2, 4-7 
word 3, 4-7 
word 4, 4-7 

word 5, 4-11 
word 7, 4-12 

word 8, 4-13 

word 9, 4-6, 4-13 

words 2-4, 4-6, 4-7, 4-10, 4-6, 6-8, 4-6 
Equipment type 

code, 4-11 

code EQT word 5 , 4-11 
Error checking 

dynamic status, 3-7 

failure analysis, 3-8 

I/O status, 3-7 

I/O status request returns, 3-9 
Error recovery, 3-7 
EXEC call 

control word, 2-1 

function code, 2-2 

request codes, 2-1 

from Assembly language, 2-7 

from FORTRAN, 2-8 

from PASCAL, 2-9 
Exit commands 

device driver, 4-8 

error types, 4-8 

new device driver request, 4-10 



Failure analysis, 3-8 
Final completion 

return to the interface driver sample code, 4-23 
Flush input buffer 

example, 2-21 
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flush active, 2-21 

flush all input buffers on that port, 2-21 
Full type-ahead 

example, 3-5 

general description, 3-5 

program scheduling, 3-5 
Function code 

EXEC call, 2-2 

H 

Handshaking 

DC1, DC2, 5-1 

enable/disable port for ENQ/ACK, 2-23 

ENQ/ACK, 5-1 

terminal, 5-2 
HP supplied 

device driver 26XX screen mode device driver, B-1 

device driver 7310 line printer device driver, B-4 

drivers, 4-3 

drivers DDV05, 4-4 

drivers DDV12, 4-3 
Hung up terminals, B-2 



I/O request 

echoing, 2-4 

editing, 2-4 

general, B-2 

terminators, 2-4 
I/O status 

example, 3-7 

general, 3-7 

parameters, 3-7 

request returns, 3-9 

status word 4, 3-7 
Interface definitions 

A-register, 4-6 

B Register, 4-6 

base page location, 4-6 

device driver, 4-6 

EQT word 10, 4-6 

EQT word 14, 4-6 

EQT word 9, 4-6 

EQT words 2-4, 4-6 

EQT words 4-10, 4-6 

EQT words 6-8, 4-6 

general description, 4-6 
Interface driver, 3-3 

A-register, 4-3 

A-register return, 4-6 

B Register, 4-3 

B Register return, 4-7 
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concept. 4-1 

concept device driver, 4-1 

device address table, 4-13 

device driver, 4-14 

device driver EQT word 1 return, 4-7 

device driver EQT word 2 return, 4-7 

device driver EQT word 3 return, 4-7 

device driver EQT word 4 return, 4-7 

DMA, 4-3 

DVMOO, 4-2 

EQT word 5, 4-7 

EXEC call handling, 4-3 

exit command, 4-8 

memory requirements, 4-14 

program scheduling, 3-3 

read function modifiers, 4-8 

request timer return, 4-7 

return to the interface driver, 4-6 

RTE, 4-3 

status for user, 4-7 

system abort requests, 4-5 

tasks general description, 4-2 

tasks interface control, 4-2 

tasks operating system interface, 4-3 

transmission log, 4-3 

use, 4-1 

user request and continuation entries, 4-6 

user transmission log return, 4-7 

write function modifier bits, 4-8 

write function modifiers, 4-8 



Line printer 

device carriage control, 4-3 
driver, 5-2 
driver DDV12, 5-2 



M 



Margin setup 

case study, 4-15 
Memory requirements 

requirements interface driver, 4-14 
Minor tasks 

case study, 4-16 
Modems, 1-4 
limitations, 5-4 
session environment, 5-4 
support, 5-4 
Modes normal mode, 3-1 
Modes type-ahead, 3-1 
Multiplexer interface responsibilities, 4-2 
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N 



No type-ahead mode 

example, 3-5 

general, 3-5 

standard RTE mode, 3-5 
Normal mode 

general description, 3-1 



Operation flow 

device driver, 4-18 
Output a set up string *-o terminal 

sample code, 4-21 
Outstanding data, 2-21 
Overflow 

error, 3-7 

error error recovery, 3-7 



Parity 

error, 3-7 

error error recovery, 3-7 
PASCAL, 2-9 
PASCAL example, 2-9 
PRMPT, 3-4 

PRMPT program scheduling, 3-4 
Program scheduling 

B Register, 3-3 

break key, 3-3 

EQLU, 3-3 

EQT word 4, 3-3 

explanation, 3-3 

normal break mode, 3-3 

PRMPT, 3-4 

programmatic setting, 3-3 

R$PN$, 3-4 

TRMLU, 3-3 



R$PN$, 3-4 

R$PN$ program scheduling, 3-4 
Re-enable schedule 
example, 2-20 
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Read 

cursor position device driver, 4-22 

cursor position sample code, 4-23 

errors, 3-8 

function modifier interface driver, 4-8 

function modifiers bit field definitions, 4-9 

function modifiers read configurations, 4-9 

request, 2-5 

Request 

timer interface driver, 4-7 
types EQT word 6, 4-12 

Return 

routine, 4-21 

routine device driver, 4-21 

to interface driver A-register, 4-7 

to interface driver B Register, 4-10 

RTE interface driver, 4-3 



SAM, 4-14 

SAM $DVTB, 4-14 

Selected EQT definitions 

equipment type code and status, 4-11 

subchannels, 4-10 
Set port 

ID baud rate, 2-22, 2-23 

ID ENQ/ACK handshaking, 2-23 

ID example, 2-24 

ID function code, 2-22 

ID general description, 2-22 

ID number of bits/char, 2-22 

ID port number, 2-24 

ID stop bits, 2-22 
Set program address 

example, 2-21 

general description, 2-21 

scheduling an unsolicited interrupt, 2-21 
Set read type 

configure a read without executing a read request, 2-30 

example, 2-30 

general, 2-30 
Set timeout 

example, 2-20 

general description, 2-20 
Set device up 

EQT extent pointers, 4-19 

EQT extent pointers sample code, 4-19 
Special considerations 

binary transfers, B-3 

character format, B-3 
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escape and unit separator treatment, B-3 

screen reads, B-3 

zero length reads, B-3 
Standard RTE mode 

no type-ahead, 3-5 
Status 

definitions, 4-1 1 

definitions EQT word 5, 4-11 

for user interface driver, 4-7 

word 4, 3-7 

word 4 I/O status, 3-7 
Subchannel determination 

new request entry, 4-20 

sample code, 4-20 
System abort request 

continuation entry, 4-5 

EQT word 2, 4-5 

EQT word 6, 4-5 

general description, 4-5 
System defined timeout 

EQT word 14, 4-13 
System or subsystem crashes, 4-5 



Table area 

area I $DVTB, 4-14 
Task definitions 

definition case study, 4-15 
Terminal driver 

driver DDV05, 5-2 
Throughput, 1-3 
Timeout clock 

clock EQT word 15, 4-13 
Timeouts, 3-7 

Timeouts error recovery, 3-7 
Transmission log 

log B Register, 4-10 
Transparent mode selection, B-5 
Type-ahead with flush on break mode 

control function 27, 3-6 

example, 3-6 

general, 3-6 
Type-ahead 

control function 27, 3-6 

cancel type-ahead data, 2-27 

description, 3-1 

enable, 2-27 

example, 3-2 

schedule, 2-27 
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U 

User transmission log 

interface driver, 4-7 
User written device driver considerations, 4-4 



W 



Write function modifier bits 
bits read related fields, 4-9 

Write modifier 

interface driver, 4-8 

Write request, 2-6 

Write request processing 

normal mode, B-5 
transparent mode, B-5 
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